

DEC-1 5-LMACA-B-D 


PDP-15 
MACRO-15 

MACRO-ASSEMBLER PROGRAM 
REFERENCE MANUAL 


Order additional copies as directed on the Software 
Information page at the back of this document. 


digital equipment corporation • maynard. massachusetts 




1st Printing October 1969 
2nd Printing (Rev) July 1970 
3rd Printing October 1971 
4th Printing (Rev) March 1972 
5th Printing (Rev) July 1973 
6th Printing (Rev) February 1974 
Revised August 1974 


The information in this document is subject to change without notice 
and should not be construed as a commitment by Digital Equipment 
Corporation, Digital Equipment Corporation assumes no responsibility 
for any errors that may appear in this manual. 

The software described in this document is furnished to the purchaser 
under a license for use on a single computer system and can be copied 
(with inclusion of DIGITAL*s copyright notice) only for use in such 
system, except as may otherwise be provided in writing by DIGITAL. 

Digital Equipment Corporation assumes no responsibility for the use 
or reliability of its software on equipment that is not supplied by 
DIGITAL, 


Copyright 

by 


©1969, 1970, 1971, 1972, 1973, 
Digital Equipment Corporation 


1974 


The HOW TO OBTAIN SOFTWARE INFORMATION page, located at the back of 
this document, explains the various services available to DIGITAL 

software users. 


The postage prepaid READER'S COMMENTS form on the last page of this 
document requests the user's critical evaluation to assist us in 
preparing future documentation. 


The following are 

trademarks of 

Digital Equipment 

Corporations 

CDP 

DIGITAL 

INDAC 

PS/8 

COMPUTER LAB 

DNC 

KA10 

QUICKPOINT 

COMSYST 

EDGRIN 

LAB-8 

RAD“”8 

COMTEX 

EDUSYSTEM 

LAB-8/e 

RSTS 

DDT 

FLIP CHIP 

LAB-K 

RSX 

DEC 

FOCAL 

OMNIBUS 

RTM 

DECCOMM 

GLC“8 

OS/8 

RT-11 

DECTAPE 

IDAC 

PDP 

SABR 

DIBOL 

IDACS 

PHA 

TYPESET 8 
UNIBUS 



CONTENTS 


PREFACE 


Page 

vii 

CHAPTER 1 

INTRODUCTION 


1.1 

MACRO-15 Language 

1-1 

1.2 

Hardware Requirements 

1-2 

1.3 

Assembler Processing 

1-2 

CHAPTER 2 

ASSEMBLY LANGUAGE ELEMENTS 


2.1 

Program Statements 

2-1 

2.2 

Symbols 

2-3 

2.2.1 

Evaluation of Symbols and GJobals 

2-4 

2.2.1.1 

Special Symbols 

2-5 

2.2.1.2 

Memory Referencing Instruction Format 

2-5 

2.2.2 

Variables 

2-6 

2.2.3 

Setting Storage Locations to Zero 

2-6 

2.2.4 

Redefining the Value of a Symbol 

2-6 

2.2.5 

Forward Reference 

2-7 

2.2.6 

Undefined Symbols 

2-8 

2.3 

Numbers 

2-8 

2.3.1 

Integer Values 

2-9 

2.3.2 

Expressions 

2-9 

2.4 

Address Assignments 

2-11 

2.4.1 

Referencing the Location Counter 

2-12 

2.4.2 

Indirect Addressing 

2-12 

2.4.3 

Indexed Addressing 

2-12 

2.4.4 

Literals 

2-13 

2.5 

Statement Fields 

2-15 

2.5.1 

Label Field 

2-15 

2.5.2 

Operation Field 

2-17 

2.5.3 

Address Field 

2-18 

2.5.4 

Comments Field 

2-20 

2.6 

Statement Evaluation 

2-21 

2.6.1 

Numbers 

2-21 

2.6.2 

Word Evaluation 

2-22 

2.6.3 

Word Evaluation of the Special Cases 

2-24 


iii 




CONTENTS (Coni') 


Page 


2.6.4 

Assembler Priority List 

2-25 

CHAPTER 3 

PSEUDO OPERATIONS 


3.1 

Program Identification (.TITLE) 

3-2 

3.2 

Object Program Output 

3-3 

3.2.1 

. ABSP, .ABS 

3-3 

3.2.2 

.FULL, C FULLP 

3-4 

3.2.3 

.EBREL and .DBREL 

3-5 

3.2.4 

Deletion of User Symbol Table (.LOCAL, .NDLOC) 

3-6 

3.2.5 

Literal Origin Pseudo-op (.LTORG) 

3-9 

3.3 

Setting the Location Counter (.LOC) 

3-10 

3.4 

Radix Control (.OCT and .DEC) 

3-10 

3.5 

Reserving Blocks of Storage (.BLOCK) 

3-11 

3.6 

Program Termination (.END) 

3-11 

3.7 

Program Segments (.EOT) 

3-12 

3.8 

Text Handling (.ASCII and .SIXBT) 

3-12 

3.8.1 

.ASCII Pseudo-op 

3-13 

3.8.2 

.SIXBT Pseudo-op 

3-13 

3.8.3 

Text Statement Format 

3-13 

3.8.4 

Text Delimiter 

3-13 

3.8.5 

Non-Printing Characters 

3-14 

3.9 

Global Symbol Declaration (.GLOBL) 

3-15 

3.10 

Requesting I/O Devices (.IODEV) 

3-16 

3.11 

Designating a Symbolic Address (,DSA) 

3-16 

3.12 

Repeating Object Coding (.REPT) 

3-16 

3.13 

Conditional Assembly (.IFxxx and .ENDC) 

3-18 

3.14 

Listing Control (.EJECT) 

3-19 

3.15 

Program Size (.SIZE) 

3-19 

3.16 

Defining Macros (.DEFIN, .ETC, and . ENDM) 

3-20 

3.17 

Assembly Listing Output Control (.NOLST & .LST) 

3-20 

3.18 

Common Block Definition (.CBD) 

3-20 

3.19 

Common Block Definition Relative (.CBDR) 

3-21 


IV 



CONTENTS (Cont) 


CHAPTER 4 

MACROS 


4.1 

Defining A Macro 

4-1 

4.2 

Macro Body 

4-2 

4.3 

Macro Calls 

4-3 

4.3.1 

Argument Delimiters 

4-5 

4.3.2 

Created Symbols 

4-6 

4.3.3 

Concatenation 

4-7 

4.4 

Nesting of Macros 

4-15 

4.5 

Redefinition of Macros 

4-16 

4.6 

Macro Calls within Macro Definitions 

4-17 

4.7 

Recursive Calls 

4-18 

CHAPTER 5 

OPERATING PROCEDURES 


5.1 

Introduction 

5-1 

5.2 

Calling Procedure 

5-1 

5.2.1 

ADSS-15 and DOS-15 

5-1 

5.2.2 

Background/Foreground (B/F) 

5-1 

5.2.3 

RSX PLUS and RSX PLUS III 

5-2 

5.3 

General Command Characters 

5-2 

5.4 

Command String 

5-3 

5.4.1 

Program File Name 

5-3 

5.4.2 

Options 

5-4 

5.4.3 

Multiple Filename Commands 

5-7 

5.4.4 

Examples of Commands for Segmented Programs 

5-9 

5.5 

Assembly Listings 

5-12 

5.6 

Symbol Table Output 

5-12 

5.7 

Running Instructions 

5-16 

5.7.1 

Paper Tape Input Only 

5-16 

5.7.2 

Cross-Reference Output 

5-17 

5.8 

Program Relocation 

5-18 

5.9 

System Error Conditions and Recovery Procedures 

5-19 

5.9.1 

ADSS-15, DOS-15 and BOSS-15 

5-19 

5.9.2 

BACKGROUND/FOREGROUND 

5-19 

5.9.3 

RSX PLUS and RSX PLUS III 

5-19 


v 




CONTENTS (Cont) 


5.9.4 Restart Control Entries 

5.10 Error Detection By the Assembler 

APPENDIX A CHARACTER SET 

APPENDIX B PERMANENT SYMBOL TABLE 

APPENDIX C MACRO-15 CHARACTER INTERPRETATION 

APPENDIX D SUMMARY OF MACRO-15 PSEUDO-OPS 

APPENDIX E SUMMARY OF SYSTEM MACROS 

APPENDIX F SOURCE LISTING OF THE ABSOLUTE BINARY LOADER 

APPENDIX G MACROI-15 ASSEMBLER ADVANCED MONITOR SYSTEM 

APPENDIX H MACROA-15 ASSEMBLER BACKGROUND/FOREGROUND 
SYSTEM 

Index 


Page 

5-19 

5-20 

A-l 

B-l 

C-l 

D-l 

E-l 

F-l 

G-l 

H-l 

1-1 



VI 



PREFACE 


The PDP-1 5 MACRO “Assembler program (MACRO-15) provides the user with the 
symbolic programming capabilities of an assembler plus the added compiler capa¬ 
bilities of a many-for-one macro instruction generator. This manual describes the 
syntax, application and operations performed by the MACRO-15 program. 

in the preparation of this manual it was assumed that the reader was familiar with 
the basic PDP-1 5 symbolic instruction set as described in either the PDP-1 5 "System 
Reference Manual DEC-1 5-ODFFA-B-D" or the "Users Handbook, Vol . 1 , Processor 
DEC-1 5-H2DA-D" . 

The MACRO-15 program may be operated in: 

a. Disk Operating System (DOS); 
b 8 Batch Operating Software System (BOSS); 

c. ADVANCED Monitor Software System (ADSS); 

d. Background/Foreground Software System (B/F); 
e„ RSX PLUS Software System 

It is assumed in this manual that the reader is familiar with the manual describing 
the software system under which MACRO-15 is to be used. 

The manuals involved are: 

a. DOS Users Manual, DEC-1 5-ODUMA-B-D, 

b. BOSS-15 Batch Operating Software System User's Manual, 

DEC-1 5-OBUMA-A-D, 

c. ADVANCED Monitor Software System For the PDP-1 5/20/30/40, 

DEC-1 5-MR2B-D, 

d. B/F Monitor Software System for PDP-1 5/30 and 15/40, DEC-1 5-MR3A-D, 

e. RSX PLUS Reference Manual, DEC-1 5-IRSXA-A-D, 

Differences in the use of MACRO-15 in the available monitor systems are described, 
where applicable, in this manual . 

Technical changes made in this revision of the manual are indicated by a bar in the 
appropriate page margin. 




CHAPTER 1 
INTRODUCTION 


1.1 MACRO-15 LANGUAGE 

MACRO-15 is a basic PDP-15 symbolic assembler language which makes machine language programming on the 
PDP~ 15 easier, faster and more efficient. It permits the programmer to use mnemonic symbols to represent in¬ 
struction operation codes, locations, and numeric quantities. By using symbols to identify instructions and data 
in his program, the programmer can easily refer to any point in his program, without knowing actual machine 
locations. 

Assembled MACRO-15 programs may be run on any PDP-15 system; however, MACRO-15 symbolic programs can 
be assembled only on systems which have at least 8K of memory and a monitor-type software system*. 

The standard output of the Assembler is a relocatable binary object program that can be loaded for debugging or 
execution by the Unking Loader. MACRO-15 prepares the object program for relocation, and the Linking 
Loader provides relocation and sets up linkages to external subroutines. Optionally, the binary program may 
be output either with absolute addresses (non-reiocatable) or in the full binary mode (see Chapter 3 for a 
description of the binary output modes). 

The programmer directs MACRO-15 processing by using a powerful set of pseudo-operation (pseudo-op) instruc¬ 
tions. These pseudo-ops are used to set the radix for numerical interpretation by the Assembler, to reserve 
blocks of storage locations, to repeat object code, to handle strings of text characters in 7-bit ASCII code or a 
special 6-bit code, to assemble certain coding elements if specific conditions are met, and to perform other 
functions which are explained in detail in Chapter 3. 

The most advanced feature of MACRO-15 is its powerful macro instruction generator* This facility permits 
easy handling of recurring instruction sequences, changing only the arguments. Programmers can use macro 
instructions to create new language elements, adapting the Assembler to their specific programming appli¬ 
cations. Macro instructions may be recursively called up to three levels, nested to n levels, and redefined 
within the program. The technique of defining and calling macro instructions is discussed in Chapter 4. 


*A device-dependent version of MACRO-15, called MACROI-15, is available for use with 8K DECtape 
systems. Refer to Appendix G. 



An output listing, showing both the programmer's source code and the object program produced by MACRO-15, 
is printed if desired. This listing may include all the symbols used by the programmer with their assigned values. 
If assembly errors are detected, erroneous lines are marked with specific alphabetic error codes, which may 
be interpreted by referring to the error list in Chapter 5 of this manual . 

Operating procedures for MACRO assembly are described in detail in Chapter 5.* (Refer to Appendix G for 
MACRO I Operating Procedures.) 

1,2 HARDWARE REQUIREMENTS 

The MACRO-15 assembler program may be run in any configuration which meets the minimum hardware 
requirements for the following PDP-15 software systems: 

a. Advanced Software System (ADSS-1 5) 
b 6 Background/Foreground (B/F) 

c. Disk Operating System (DOS-15) 

d. Batch Operating Software System (BOSS-15) 

e. Resource Sharing eXecutive (RSX PLUS and RSX PLUS III) 

1 .3 ASSEMBLER PROCESSING 

The MACRO-15 assembler processes source programs in either a two-pass or three-pass operation. In the 
two-pass assembly operation the source program is read twice with the object program and printed listing 
(both optional) being produced during the second pass. During the first pass (PASS 1), the locations to 
be assigned the program symbols are resolved and a symbol table is constructed by the assembler. The second 
pass (PASS 2) uses the information computed during PASS 1 to produce the final object program. 

In an optional three-pass assembly operation, PASS 2 will call in a third pass (PASS 3) portion of the assembler 
program. PASS 3, when called, performs a cross referencing operation during which a listing is produced 
which contains: (a) all user symbols, (b) where each symbol is defined, and (c) the number of each pro¬ 
gram line In which a symbol is referenced. On completion of its operation, PASS 3 calls the PASS 1 and 
PASS 2 portions of the assembler program back into core for further assembly operations. 


*These procedures are also mentioned in the DOS-15 Keyboard Command Guide, 
(DEC-15-ODKCA-A-D) and the PDP-15/20 User's Guide, (DEC-15-OUGAA-A-D). 
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The standard object code produced by MACRO-15 is in a relocatable format which is acceptable to the PDP-15 
Linking Loader, CHAIN, PATCH and TKB Utility programs. Relocatable programs that are assembled separately 
and use identical global symbols* where applicable, can be combined by the Linking Loader, CHAIN, and TKB 
into an executable object program. MACRO-15 reserves one additional word in a program for every external 
symbol** . This additional word is used as a pointer (called a transfer vector) to the actual data word in another 
program. The Linking Loader sets up these transfer vectors (when the programs are loaded) with the actual 
address of the global symbol e 

Some of the advantages of having programs in relocatable format are as follows: 

a. Reassembly of one program, which at object time was linked with other programs, does not 
necessitate a reassembly of the entire system* 

b 8 Library routines (in relocatable object code) can be requested from the system device or 
user library device* 

c. Only global symbol definitions must be unique in a group of programs that operate together. 


^Symbols which are referenced in one program and defined in another* 

**Symbols which are referenced in the program currently being assembled but which are defined 
in another program* 
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CHAPTER 2 

ASSEMBLY LANGUAGE ELEMENTS 


2.1 PROGRAM STATEMENTS 

One or more statements may be written on a line of up to 76 characters where the last character is a carriage- 
return. Since the carriage return is a non-printing character, it is graphically represented as^Jin this manual, 

e.g., 

STATEMENT^ 

Several statements may be written on a single line, separated by semicolons 
STATEMENT;STATEMENT;STATEMENTJ 

Only the last statement may have a comments field, since semicolons are allowed in and do not delimit 
comments. Also, MACRO calls (a type of statement described in a later chapter) should not appear in a 
multi-statement line since they cause subsequence statements to be ignored. 

Normally, a single statement must fit on one line. The exception to this rule is a macro call whose 
arguments may be continued on a subsequent line by use of the $ character. This is described in the 
chapter on MACROs. 

A statement may contain up to four fields that are separated by a space, spaces, or a tab character. These four 
fields are the label (or tag) field, the operation field, the address field, and the comments field. Because the 
space and tab characters are not printed, the space is represented by lmmI , and the tab by -&j in this manual . 
Tabs are set 8 spaces apart on DEC-supplied teleprinter machines, and are used to line up the fields in 
columns in the source program listing. 

This is the basic statement format: 

LABEL H OPERATION H ADDRESS H /COMMENTS J 

where each field is delimited by a tab or space, and each statement is terminated by a semicolon or carriage- 
return. The comments field is preceded by a tab (or space) and a slash(/). 
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Note that a combination of a space and a tab wil 
del imiters. 


be interpreted by the MACRO-15 assembler as two field 


Example: 

TAG -*| OP l-j -*| ADR^l both are 
TAGlj -&|OP -e&JADR^j incorrect 

These errors will not show on the listing because the space is hidden in the tab. 

A MACRO-15 statement may have an entry in each of the four fields, or three, or two, or only one field. The 
following forms are acceptable (where the characters (s) indicate one or more of the preceding character): 


TAG J 

TAG 

H OP J 


TAG 

H OP 

-*j ADDR^ 

TAG 

H op 

-*| ADDRu (s) / comments^ 

TAG 

Hop^ 

(s) / comments^ 

TAG 

H 

Haddr J 

TAG 

H 

HADDRu (s) / comments^ 

TAG 

-*| (s) / comments^ 


^opJ 

-^OP 

-*j addrJ 


Hop 

H ADDR H (s) / comments^ 


Hop 

-*\ (s) / comments^ 


H 

H addrJ 


H 

ADDR -*| (s) / comments^ 


/comments J 

-i(s) / comments^ 


Note that when a label field is not used, its delimiting tab is written, except for lines containing only comments. 
When the operation field is not used, its delimiting tab is written if an address field follows, except in label 
only and comments only statements. 

A label (or tag) is a symbolic address created by the programmer to identify the statement. When a label is 
processed by the Assembler, it is said to be defined. A label can be defined only once. The operation code 
field may contain a machine mnemonic instruction code, a MACRO-15 pseudo-op code, a macro name, a num¬ 
ber, or a symbol. The address field may contain a symbol, number, or expression which is evaluated by the 
assembler to form the address portion of a machine instruction. In some pseudo-operations, and in macro 
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instructions, this field is used for other purposes, as will be explained in this manual. Comments are usually 
short explanatory notes which the programmer adds to a statement as an aid in analysis and debugging. Comments 
do not affect the object program or assembly processing. They are merely printed in the program listing. Com¬ 
ments must be preceded by a slash (/). The slash (/) may be the first character in a line or may be preceded by: 

a. Space (. .) 

b. Tab(H) 

c . Semicolon (;) 


2.2 SYMBOLS 

The programmer creates symbols for use in statements to represent addresses, operation codes and numeric values. 
A symbol contains one to six characters from the following set: 

The letters A through Z 
The digits 0 through 9 

Two special characters, period ( . ) and the percent sign (%). 


The first character of a symbol must be a letter, a period, or percent sign. A period may not be used alone as a 
symbol . The first character of a symbol must not be a digit. The letter ! X' alone may not be a symbol . ( f X ! 
has a special meaning to the Assembler, as explained later*) 

The following symbols are legal: 


MARKl 

A% 

P9.3 

The following symbols are illegal: 

TAG:! 

5ABC 

X 


..1234 .A 

%50.99 .% 

INPUT 

: is not a legal symbol character. 
First character may not be a digit. 
Letter 'X ! alone is illegal, 

' alone is illegal as a symbol . 


Only the first six characters of a symbol are meaningful to the Assembler, but the programmer may use more for 
his own information. If he writes, 


SVMBOL1 

SYMBOL2 

5YMBOL3 
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as the symbolic labels on three different statements in his program, the Assembler will recognize only SYMBOL 
and will print "m" error flags on the lines containing SYMBOL! , SYMBOL2 and SYMBOL3. To the Assembler 
they are duplicates of SYMBOL. 

2*2*1 Evaluation of Symbols and Globals 

When the Assembler encounters a symbol during processing of a source language statement, it evaluates the sym¬ 
bol by referring to two tables: the user's symbol table and the permanent symbol table. The user's symbol table 
contains all symbols defined by the user* The user defines symbols by using them as labels, as variables, as 
macro names and globals, and by direct assignment statements* A label is defined when first used, and cannot 
be redefined* (When a label is defined by the user, it is given the current value of the location counter, as will 
be explained later in this chapter*) 

All permanently defined system symbols (excluding the index register symbol, X), including system macros 
(except for RSX) and all Assembler pseudo-instructions use a period (.) as their first character. The Assembler 
also has, in its permanent symbol table, definitions of the symbols for ail of the PDP-15 memory reference in¬ 
structions, operate instructions, the basic EAE instructions, and some input/output transfer instructions. (See 
Appendix B for a complete list of these instructions.) 

PDP-15 instruction mnemonic symbols may be used in the operation field of a statement without prior definition 
by the user. 

Example: 


H LAC U A J LAC is a symbol whose appearance in the operation 

field of a statement causes the Assembler to treat it 

as an op code rather than a symbolic address. It has 

a value of 20000CL which is taken from the operation 
o 

code definition in the permanent symbol fable. 

The user can use instruction mnemonics or the pseudo-instruction mnemonics code as symbol labels. For example, 
DZM H DZM^Y J 

where the label DZM is entered in the symbol table and is given the current value of the location counter, and 
the op code DZM is given the value 140000 from the permanent symbol fable. The user must be careful, how¬ 
ever, in using these dual purpose (field dependent) symbols. Symbols in the operation field are interpreted as 
either instruction codes or pseudo-ops, not as symbolic labels, if they are in the permanent symbol fable. 

| System macro names cannot be duplicated by the user. In the following example, several symbols 
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with values have been entered in the user's symbol table and the permanent symbol table. The sample coding 
shows how the Assembler uses these tables to form object program storage words. 


User Symbol Table 

Permanent Symbol Table 

Symbol 

Value 

Symbol 

Value 

TAG! 

100 

LAC 

200000 

TAG2 

200 

DAC 

040000 

DAC 

300 

JMP 

600000 



X 

010000 


If the following statements the following code is generated 

are written, by the Assembler 


TAG! H DAC H TAG2 040200 

TAG2 H LAC H DAC 

DAC H JMP H TAG1 

H DAC H TAG 1 ,X 
H TAG1 

2.2. 1 .1 Special Symbols - The symbol X is used to denote index register usage. It is defined in the permanent 
symbol table as having the value of 10000. The symbol X cannot be redefined and can only be used in the ad¬ 
dress field. 

2.2.1.2 Memory Referencing Instruction Format - When operating in page mode the PDP-1 5 uses 12 bits for 
addressing, 1 bit to indicate index register usage, 1 bit to indicate indirect addressing, and 4 bits for the op code. 


200300 


600100 

050100 

000100 


0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 


Op Code 



Address 


A A . .. " . 

C Index Register Bit 

■““indirect Addressing 

PAGE MODE MEMORY REFERENCE INSTRUCTION 


When operating in bank mode on the PDP-1 5, the only mode that applies to the PDP-9, 13 bits are used for 
addressing, there is no index register bit, I bit is for indirect addressing, and 4 bits are for the op code. 




10 11 


12 13 


15 16 17 


Op Code 


Address 


t 


Indirect Addressing 


BANK MODE MEMORY REFERENCE INSTRUCTION 
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2.2.2 Variables 


A variable is a symbol that is defined in the user's symbol table by using it in an address field or operation field 
with the number sign (^). Symbols with the ^ may appear more than once in a program (see items 1 , 3, 4, and 5 
of example given below). A variable reserves a single storage word which may be referenced by using the sym¬ 
bol at other points in the program with or without the #. If the variable duplicates a user-defined label, it is 
multiply defined and is flagged as an error during assembly. 

Variables are assigned memory locations at the end of the program. The initial contents of variable locations 
are unspecified. The ^ can appear any place within the symbol character string as in the example. 

Example: 


Sequence 

Location 

Counter 

Source Statements 

Generated 

Code 



H 

.LOG 100 


1 

100 

H 

LAC i_i TA^GI 

200105 

2 

101 

H 

DAC l _ J . TAG3 

040107 

3 

102 

H 

LAC t _ ) .TAG2^ i 

200106 

4 

103 

H 

DACT # AG3 ,X 

050107 

5 

104 

H LAC l _ J #TAG2 

200106 



H 

.END 



2 8 2«3 Setting Storage Locations to Zero 
Storage words can be set to zero as follows: 

A H 0; H 0; H 0 ) 

In this way, three words are set to zero starting at A. Storage words can also be set to zero by statements con¬ 
taining only labels 

A; B; C; D; E J 

2.2 A Redefining the Value of a Symbol 

The programmer may define a symbol directly in the user's symbol table by means of a direct assignment 
statement written in the form: 

SYMBOL-nJ 

or 

SYM1-SYM2J 

where n is any number or expression. There should be no spaces between the symbol and the equal sign, or be¬ 
tween the equal sign and the assigned value, or symbol. MACRO-l 5 enters the symbol in the symbol table, along 
with the assigned value. Symbols entered in this way may be redefined. These are legal direct assignment state- 

mens: XX-28;A=1 ;B=2 J 

A symbol can also be assigned a symbolic value; e.g., A-4, B=A, or 
SET^ISZ^WITCH J 
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CN CO xj- 


In the previous example, the symbol B is given the value 4, and when the symbol SET is detected during assemb'y 
the object code for the instruction ISZ. .SWITCH will be generated. This type of direct assignment cannot be 
used in a relocatable program. Direct assignment statements do not generate storage words in the object program. 

in general, it is good programming practice to define symbols before using them in statements that generate 
storage words. The ASSEMBLER will interpret the following sequence without trouble: 


1 

2 

3 

4 

5 

6 

7 


000005 

000005 

000005 

00000 200005 

000000 

SI ZE=00001 


2.2.5 Forward Reference 


. ABSP 

Z=5 

Y=Z 

XX=Y 

/ 

LAC XX /SAME AS LAC 5 
.END 

NO ERROR LINES 


A symbol may be defined after use. For example, 

00000 200001 


.ABSP 
LAC Y 


000001 Y=1 

000000 .END 

SIZE=00001 NO ERROR LINES 


This is called a forward reference, and is resolved properly in PASS 2. When first encountered in PASS 1, the 
LAC Y statement is incomplete because Y is not yet defined. Later in PASS 1, Y is given the value 1. In 
PASS 2, the Assembler finds that Y=1 in the symbol table, and forms the complete storage word. 


Since MACRO-15 basic assembly operations are performed in two passes, only one-step forward references are 
allowed. The following example is illegal because the symbol Y is not defined during PASS 2. 


00100 A 

F 00100 A 200000 A 

000001 A Y=Z 
000001 A Z=1 
000000 A 


.LOC 100 
LAC Y 


.END 


SIZE=00101 1 ERROR LINES 

Forward references to internal .GLOBL symbols (see Paragraph 3.9) are illegal because the infernal globais are 
output at the beginning of PASS 2 for library searching. Globais must be defined during PASS 1, otherwise 


5 

6 
7 


be flagged 

• 

The following example is 

i llega 1: 






• GLOBL A, B,C 

00000 

R 

200000 

A 

LAC 

A 



000004 

R A=E 



00001 

R 

200002 

R 

LAC 

D 

00002 

R 

120005 

E D 

JMS* 

B 

00003 

R 

120006 

E E 

JMS* 

C 



000000 

A 

.END 


00005 

R 

000005 

E *E 



00006 

R 

000006 

E *E 




SIZE=00007 


2 ERROR LINES 
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2.2.6 Undefined Symbols 

If any symbols, except global symbols, remain undefined at the end of PASS 1 of assembly, they are 
automatically defined as the addresses of successive registers following the block reserved for variables at the 
end of the program. All statements that referenced the undefined symbol are flagged as undefined. One 
memory location is reserved for each undefined symbol with the initial contents of the reserved location being 


unspecified. 




Examples: 




I 



. ABSP 

2 

00100 

i 

.LOG 100 

3 U 

00100 

200106 

LAC UNDEF1 

4 

00101 

200104 

LAC TAG# 

5 

00102 

200105 

LAC TAG# 1 

6 U 

00103 

200107 

LAC UNDEF2 

7 


000000 

.END 



SIZE=00110 

2 ERROR LINES 


2.3 NUMBERS 

The initial radix (base) used in all number interpretation by the Assembler is octal (base 8). To allow the user 
to express decimal values and then restore to octal values, two radix-setting pseudo-ops (.OCT and .DEC) are 
provided. These pseudo-ops, described in Chapter 3, must be coded in the operation field of a statement. If 
any other information is written in the same statement, the Assembler treats the other information as a comment 
and flags it as a questionable line. All numbers are decoded in the current radix until a new radix control 
pseudo-op is encountered. The programmer may change the radix at any point in the program. 

Examples: 


Flag 

Source Program 

Generated Value (Octal) 

Radix in Effect 


H LAC H 100 

200100 

8 ^ initial value is 


H 25 

000025 

8 J assumed to be octal 


H .DEC 




H LAC H 100 

200144 

10 


H 275 

000423 

10 

Q 

H . OCT 99 


Octal radix takes effect even 




though line is flagged 


H 76 

000076 

8 

N 

H 99 

000143 

The non“Oeta 1 digit forces a 




decimal radix for this number only j 
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2.3.1 Integer Values 

An integer is a string of digits, with or without a leading sign. Negative numbers are represented in two's 
complement form. The range of integers is as follows: 

1 o 

Unsigned 0 -*262143^ (777777^ or 2 -1 

Signed 0 -131071 10 (377777g) or 2 17 -1 

0+-131072 10 (400000 g) 'or-2 17 

An octal integer* is a string of digits (0-7), signed or unsigned. If a non-octal digit (8 or 9) is encountered 
the string of digits will be assembled as if the decimal radix were in effect and it will be flagged as a possible 
error. 

Example: 


Flag 

Coded Value 

Generated Value (Octal) 

Comment j 


.DEC 




3779 

007303 



.OCT 




-5 

777773 

Two's complement 


3347 

003347 


N 

3779 

007303 

Possible error, decimal 
assumed 


A decimal integer** is a string of digits (0-9), signed or unsigned. 
Examples: 


2.3.2 Expressions 

Expressions are strings of symbols and numbers separated by arithmetic or Boolean operators. Expressions repre- 

18 

sent unsigned numeric values ranging from 0 to 2 -1. All arithmetic is performed in unsigned integer arithmetic 


Flag 

Coded Value 

Generated Value (Octal) 

Comment 


-8 

777770 

Two's complement 


+256 

000400 


N 

-262144 

000000 

Error, less than -(2^-1) 



initiated by .OCT pseudo-op and is also the initial assumption if no radix control pseudo-op is encountered. 
**Initiated by .DEC pseudo-op. 
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(two's complement), modulo 2 . Division by zero is regarded as division by one and results in the original 

dividend. Fractional remainders are ignored; this condition is not regarded as an error. The value of an ex¬ 
pression is calculated by substituting the numeric values for each element (symbol) of the expression and per¬ 
forming the specified operations. 

The following are the allowable operators to be used with expressions: 


Character 

Function 

Name 

Symbol 



Plus 

+ 

Addition (two's complement) 

Minus 

- 

Subtraction (convert to two's complement and add) 

Asterisk 

* 

Multiplication (unsigned) 

Slash 

/ 

Division (unsigned) 


Ampersand 

& 

Logical AND 


Exclamation point 

! 

Inclusive OR 


Back slash 

\ 

Exclusive OR 

f Boolean 

Comma 

r 

Exclusive OR 

J 



Operations are performed from left to right (i.e. , in the order in which they are encountered). For example, 
the assembly language statement A+B*C+D/E-F*G is equivalent to the following algebraic expression 

(((((A+B)*C)+D)/E)-F)*G. 

Examples: 

Assume the following symbol values: 


Symbol 

Value (Octal) 

Comments 

A 

000002 


B 

000010 


C 

000003 


D 

000005 


X 

010000 

Index Register Value 


The following expressions would be evaluated. 
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Expression 

Evaluation (Octal) 

Comments 

A+B-C,X 

010007 

Index Register Usage 

A/B+A*C 

000006 

(The remainder of A/B is lost) 

B/A-2*A-1+X 

010003 

Index Register Usage 

A & B 

000000 


C+A&D 

000005 


B*D/A 

000024 


B*C/A*D 

000074 


A,X+D,X 

010007 

Index Register Usage Error 


In the last example the expression is evaluated as follows: 

Sequence of arithmetic 

a. A,X = 000002 XORed with 010000 = 010002 

b. A, X+D = 010002 + 000005 = 010007 

c. A, X+D, X = 010007 XORed with 010000- 000007 


Note that arithmetic produces 000007 yet the value given in the example is 010007. Regardless of how the In¬ 
dex register is used in the address field, the index register bit will always be turned on by the Assembler. In 
the sequence of address arithmetic above, the line would be flagged with an X because of the illegal use of the 
index register symbol (X). 

Using the symbol X to denote Index register usage causes fhe following restrictions: 


a. X cannot appear in the TAG field 

b. X cannot be used in a .DSA statement 

c. X can be used only once In an expression 
(see 2.4.3) 

2.4 ADDRESS ASSIGNMENTS 


X H LAC H A 
• DSA-H a,x 
LAC Ha, X+D,X 


As source program statements are processed, the Assembler assigns consecutive memory locations to the storage 
words of the object program. This is done by reference to the location counter, which is initially set to zero 
and Is incremented by one each time a storage word is formed in the object program. Some statements, such as 
machine instructions, cause only one storage word to be generated, incrementing the location counter by one. 
Other statements, such as those used to enter data or text, or to reserve blocks of storage words, cause the 
location counter to be incremented by the number of storage words generated. 
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2.4.1 Referencing the Location Counter 

The programmer may directly reference the location counter by using the symbol period ( . ) in the address field. 
He can write, 


H JMP._j.-l 

which will cause the program to jump to the storage word whose address was previously assigned by the location 
counter. The location counter may be set to another value by using the . LOC pseudo-op, described in Chapter3. 

2.4.2 Indirect Addressing 

To specify an indirect address, which may be used in memory reference instructions, the programmer writes an 
asterisk immediately following the operation field symbol. This sets the defer bit (bit 4) of the storage word. 

If an asterisk suffixes either a non-memory reference instruction, or appears with a symbol in the address field, 
an error wi 11 result. 

Two examples of legal indirect addressing follow. 

H TAD*H A 
H LAC*HB 

The following examples are illegal. 

CLA* Indirect addressing may not be specified 

LAW* 17777 in non-memory reference instructions. 

2.4.3 Indexed Addressing 

To specify indexed addressing an X is used with an operator directly after the address* No spaces or tabs 
may appear before the operator. The Assembler will perform whatever operation is specified with the index reg¬ 
ister symbol, and then continue to evaluate the expression. At completion of the expression evaluation, if the 
index bit (bit 5) is not on and the location counter is pointing to page 0 of any bank, the line is flagged with 
a B for bank error because the address (aside from indexing modifications) must have been greater than 7777^ 

(i B e o, it pointed to another page). The standard code used to indicate indexing is: 


LAC A,X 

The indexed addressing operation is illustrated in the following example. 
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Example: 




Location 

Object 

Code 


. ABSP 



000000 

210000 

A 

LAC H 

X 

/Same as LAC 0,X 

000001 

050005 

B 

DAC H 

A,X+1,7-1 

/ 

000002 

210001 


LAC - 
. LOC 

B+X 

10000 

/000001 + 010000 
/SET to page 1 

010000 

210001 

C 

LAC 

X,D 


010001 

210000 

D 

LAC 

.END 

C,X 



Expression evaluation where A = 000000, B = 000001, C = 010000, 0=01 0001, X=01 0000 

NOTE: 0 - exclusive OR 



Location 

Address Field 

Discussion 


0 

X 

The value of X is added to 0, Absence of 
an operator always implies addition» 


1 

A,X+1,7-1 

000000©010000 - 010000 

010000 + 000001 = 010001 
0100010000007 = 010006 

010006 - 000001 = 010005 


2 

B+X 

000001 0010000 = 010001 


10000 

X,D 

010000 0010001 =000001 

The index bit has been turned off during 
expression evaluation. Because the lo¬ 
cation counter (10000) is pointing to 

Page 1, this line is not flagged, and the 
index register bit is turned on. 


10001 

C,X 

010000001G000 = 000000 

Same as example at Location 10000, 


2.4.4 Literals 

Symbolic data references in the operation and address fields may be replaced with direct representation of the 
data enclosed in parentheses*. This inserted data is called a literal. The Assembler sets up the address link, 
so one less statement is needed in the source program. The following examples show how literals may be used, 
and their equivalent statements. The information contained within the parentheses, whether a number, symbol, 
expression, or machine instruction, is assembled and assigned consecutive memory locations after the locations 
used by the program, unless a .LTORG pseudo-instruction appears in the program. (See section 3.2,5.) 

The address of the generated word will appear in the statement that referenced the literal . 


*The opening parenthesis [(] 


is mandatory; the closing parenthesis [)] is optional. 
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Duplicate literals, completely defined when scanned in the source program during PASS 1, are stored only once 
so that many uses of the same literal in a given program result in the allocation of only one memory location for 
that literal „ Nested literals, that is, literals within literals, are illegal and will be flagged as an error. The 
following is an example of a nested literal. 

L ACi_i(A D Di_j(3) ) 


Usage of Literal 

Equivalent Statements 

H add^ o) 

H ADDONE 

ONE H 1 

H LAC ^ (TAG) 

H LAC j_i TAGAD 
TAGAD H TAG 

H LAC (DAC H TAG) 

H LAC ^ INST 

INST H DAC H TAG 

H LAC j_j (JMP H .+2) 

HERE H LAC ^ INST 

INST H JMP^ HERE+2 


The following sample program illustrates how the Assembler handles literals. 


Location Counter 

Source Statement 

Generated Code 


-*j . LOC u 100 


100 

tagH lac ^(100) 

200110 

101 

H DAC^ 100 

040100 

102 

H LAC (JMP | _ J , .+5 

200111 

103 

-1 LAC ^(TAGl) 

200110 

104 

H LAC ^(JMP^TAGl) 

200113 

105 

H LAC i _ j (JMP l _ r TAG2) 

200112 


TAG2=TAG1 


106 

H LAC (JMP 0) 

200113 

107 

DAC H LAC ^.(DAC H DAC) 

200114 


H .END 



Generated Literals 


no 


000100 

in 


600107 

112 


600100 

113 


600000 

114 


040107 
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2.5 STATEMENT FIELDS 


The following paragraphs provide a detailed explanation of statement fields, including how symbols and numbers 
may be used in each field. 

2.5.1 Label Field 

If the user wishes to assign a symbolic label to a statement in order to facilitate references to the storage word 
generated by the Assembler, he may do so by beginning the source statement with any desired symbol. The 
symbol must not duplicate a system or user defined macro symbol and must be terminated by a space or tab, or a 
statement terminating semicolon or carriage-return. 

Examples: 


TAG1;TAG2;TAG3;TAG4 A new logical line starts after each 

semicolon. This line is equivalent to 

tagH o ) 

TAG2H O j 
TAG3H 0 ) 

TAG4-H OJ 

If there were a tab or a space after the semicolon the symbol would be evaluated as an operator instead of a 
tag. The sequence 

TAG 1; ^ TAG2;T AG3; ^ TAG4 

is evaluated as follows: 

TAGl H Oj 

TAG2 J 
TAG3 H 0 J 

TAG4 J 

TAG any value 
TAG u (s) any value 
TAG H u (s) any value 
TAG; 

TAGJ 

TAG | _ J (s) (no more data on line) 

When writing numbers separated by semicolons, the first number must be preceded by a tab ( -*| ) or a space ( ) 

The sequence 


These examples are equivalent to coding 
TAG H QJ 

in that a word of all Os is output with 
the symbol TAG associated with it. 


TABLE b _ # ];2;3;4;5 



produces TAG errors because the first symbol of a tag cannot be numeric. The correct way to write the table 
sequence is as follows: 

TABLE 1;,_, 2; 1 _ 1 3; u 4; u 5 

Symbols used as labels are defined in the symbol table with a numerical value equal to the present value of the 
location counter. A label is defined only once. If it was previously defined by the user, the current definition 
of the symbol will be flagged in error as a multiple definition. All references to a multiply defined symbol will 
be converted to the first value encountered by the Assembler. 

Example: 


Flag 

Location 

Counter 

Statement 

Storage Word 
Generated 

Notes 

M 

100 

aH lacH b 

200103 


M 

101 

A H LAC H C 

200104 "I 

Error, multiple definition 

D 

102 

H LAC H A 

200100 j 

First value of A referenced 


103 

B H 0 

000000 



104 

c H o 

000000 



Anything more than a single symbol to the left of the label-field delimiter is an error; it will be flagged and 
ignored. The following statements are illegal. 

TAG+1 H LAS J 
LOC*2 H RAR J 

The line will be flagged with a "T" for tag error. The tag will be ignored but the rest of the line will continue 
to be processed. The only time that an error tag is not ignored is when the error occurs after the sixth character. 
The statement: 


TAGERROR*! ^ NOP 

will be assembled as: 

TAGERR H NOP 

and the line will be printed and flagged with a "T 11 . 

Redefinition of certain symbols can be accomplished by using direct assignments; that is, the value of a symbol 
can be modified. If an Assembler permanent symbol or user symbol (which was defined by a direct assignment) 
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is redefined, the value of the symbol can be changed without causing an error message. If a user symbol, which 
was first defined as a label, is redefined by either a direct assignment or by using it again in the label field, it 
will cause an error. Variables also cannot be redefined by a direct assignment. 

Examples:_ 


Coding 

Generated Value (Octal) 

Comments 

A=3 


Sets current value of A to 3 

H LAC -*|A 

200003 


H dacha 

040003 


A-4 


Redefines value of A to 4 

H lac Ha 

200004 


B H DAC H A 

040004 

* 

B=A 


Illegal usage; a label cannot 
be redefined 

H DAC H B' 

040105 


PSF=700201 


To redefine possibly incorrect 
permanent symbol definition. 


*Assume that this instruction will occupy location 105. 


2.5.2 Operation Field 

Whether or not a symbol label is associated with the statement, the operation field must be delimited on its left 

by a space(s) or tab. If it is not delimited on its left, it will be interpreted as the label field. The operation 

field may contain any symbol, number, or expression which will be evaluated as an 18 -b i t quantity using un- 

18 

signed arithmetic modulo 2 . In the operation field, machine instruction op codes and pseudo-op mnemonic 

symbols take precedence over identically named user defined symbols. The operation field must be terminated 
by one of the following characters: 

H or i_j ( s ) (field delimiters) 

J or ; (statement delimiters) 

Examples: 

tag-H ISZ 

H •+3 f _j (s) 

^(sJCMAiCML J 

H TAG/5+TAG2; H TAG3 J 

The asterisk (*) character appended to a memory reference instruction symbol, in the operation field, causes 
the defer bit (bit 4) of the instruction word to be set; that is, the reference will be an indirect reference. If 
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the asterisk (*) is appended on either a non-memory reference instruction or any symbol in the address field, 
it will cause an error condition which will be flagged as a symbol error (S-flag). The asterisk will be ignored 
and the assembly process will continue. 

Examples: 


Assembled Value 

Legal 

Assembled Value 

Illegal 

360001 

H TAD* H A 

200001 

H LAC H A* 

220002 

H LAC*H B 

750000 

Hcla* 


where A = 1 and B = 2 

However, the asterisk (*) may be used anywhere as a multiplication operator. 
Examples: 


Legal 

II legal 

H LAC H TAG*5 

H TAG*TAG1 

H LAC H TAG*4+TAD* 

H A* 


2.5.3 Address Field 

The address field, if used in a statement, must be separated from the operation field by a tab, or space(s). The 
address field may contain any symbol, number, or expression which will be evaluated as an 18-bit quantity 
using unsigned arithmetic, modulo 2^. If op code or pseudo-op code symbols are used in the address field, 
they must be user defined, otherwise they will be undefined by the Assembler and will cause an error message. 
The address field musi be terminated by one of the following characters: 


or ^ (s) (field delimiters) 

J or ; (statement delimiters) 


Examples: LAW -1 

LAW-1 


/Correctly assembled as 777777 

/No separation from the operation field; assembled as 757777 since -1 is 
is treated as part of the operation field e 


TAG2 H DAC H .+3 

H H TAG2/5+3 (s) 


In the last example, the rest of the line will be automatically treated as a comment and ignored by the Assembler. 
The address field may also be terminated by a semicolon or a carriage-return. 
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Examples: 


H jmpH BEGIN ) 

H TAD H A; H DAC H B H LAC 


In the last example, a tab or space(s) is required after the semicolon in order to have the Assembler interpret 
DAC as being the operation field rather than the label field. 

In the second line of the preceding example, the address field B is delimited by a tab. The LAC after the B H 
is ignored and is treated as a comment; but, the line is flagged as questionable because only a comment field 
may occur on a line after the address field* If the LAC had been preceded by a slash (/), the line would have 
been correct. 


When the address field is a relocatable expression, an error condition may occur. If the program is being assem¬ 
bled to run in page mode, it could not execute properly if its size exceeded 4K (4096) words because it would 
have to load access a memory page or bank boundary. In practice, the binary loaders restrict the size to 4K-16 
(4080) to avoid loading a program into the first 16 locations in a memory page or bank. This avoids a possible 
ambiguity where indirect memory references would be mistaken for autoincrement register references. Consequently, 
any relocatable address field whose value exceeds 4095 (7777^ is meaningless in page mode and will be flagged 
by the Assembler as an error. 

There is a similar size restriction for programs being assembled to operate in bank mode. The Assembler flags in 

error any relocatable address field whose value exceeds 8191 (1 7777 ). The binary loaders restrict the size of 

a 

bank mode programs to 8K-1 6 (8176) words. 


When the address field is an absolute expression, an error condition will exist if the extended memory and page 
address bits (3, 4 and 5) do not match the corresponding bits of the address of the page currently being assembled 

mt0, NOTE 


In absolute mode, the page bits do not have to be equal 
if the .ABS or .FULL pseudo-ops are used instead of the 
.ABSP or .FULLP pseudo-ops. 


Examples: 


Flag 

Location 

(octal) 

Instruction 

Comments 


30000 

H LAC ^ 30100 

No error message 

B 

30001 

H DAC^.101 

> Will cause a bank (B) error message 

B 

30002 

H JMS ^ 250 

> because the address is on a different 

B 

30005 

HlSZ,^ 40146 

J page and bank* 


The Linking Loader will not relocate any absolute addresses; thus, absolute addresses within a relocatable program 
are relative to that page in memory in which the program is loaded. 
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Example: 


Assume that the following source line is part of a relocatable program that was loaded into bank 1 

(20000 o -37777J. 

o o 


Source Statement 

Effective Address 

H LAC ^ 300^ 

20300 


An exception to the above rule is the auto-index registers, which occupy location 10 

o 

memory bank 0. The hardware will always ensure that indirect references to 10^ - 17g 
will access 10 n 


8 


17 of bank 0. 
o 


- 17 in page 0 of 
o 

in any page or bank 


2.5.4 Comments Field 

Comments may appear anywhere in a statement. They must begin with a slash (/) that is immediately preceded 
by 


a. (s) 

b. H 
c- J 
d. ; 


space (s) 
tab 

carriage return/line feed (end of previous line) 
semicolon 


Comments are terminated only by a carriage-return or when 76.^ characters have been encountered in a 


Examples: 


(s)AHIS IS A COMMENT (rest of line is blank) 

TAG! H LAC ^ 

/THIS IS A COMMENT 

H RTR ^/COMMENT J 

H RTR; H RTR;/THIS IS A COMMENT 

Observe that ; H A/COMMENT^) is not a comment, but rather an operation field expression, A line that is 
completely blank (containing 0 to 75 blanks/spaces) is treated as a comment by the Assembler. 
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A statement is terminated as follows: 


J or ; or rest of line is completely blank. 

Examples: 

H LAC J 

H DAC (the rest of the line is blank) 

H TAG+3 

H RTR; H RTR; -*) RTRj 

In the last example, the statement-terminating character, which is a semicolon (;) enables one source line to 
represent more than one word of object code. A tab or space is required after the semicolon in order to have 
the second and third RTRs interpreted as being in the operation field and not in the label field. 

2.6 STATEMENT EVALUATION 

When MACRO-15 evaluates a statement, it checks for symbols or numbers in each of the three evaluated fields: 
label, operation, and address. (Comment fields are not evaluated.) 

2.6.1 Numbers 

Numbers are not field dependent. When the Assembler encounters a number (or expression) in the operation or 
address fields (numbers are illegal in the label field), it uses those values to form the storage word. The follow¬ 
ing statements are equivalent: 

H 200000^10 J 
H 10+LAC J 
H lac^io^ 

All three statements cause the Assembler to generate a storage word containing 200010. A statement may con¬ 
sist of a number or expression which generates a single 18-bit storage word; for example: 

H 23; l _ 1 45; l _ j 357; 1 _ 1 62 

This group of four statements generates four words interpreted under the current radix. 
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2.6.2 Word Evaluation 


When the Assembler encounters a symbol in a statement field, it determines the value of the symbol by reference 
to the user's symbol table and the permanent symbol table, according to the priority list shown in paragraph 2.6,4. 


The operation value is scanned for the following special cases: 


Mnemonic 

Operation Field Value 

. LAW 

760000 

AAC 

723000 

AXR 

737000 

AXS 

725000 

EAE instructions 

64xxxx 


If the operation field is not one of the special cases, the object word value is computed as follows: 

If assembling for page mode: 

(Operation Field +(Address Field & 7777))-Word Value 
If assembling for bank mode: 

(Operation Field ^(Address Field & 17777))~Word Value 

If the index register is used anywhere in the address field, the index register bit is set to one in the word value. If 
it is not used, and you are assembling with .ABSP, .FULLP or .DBREL then the index register bit is set to zero in 
the word value regardless of the address field value, 

a. If index register usage is specified, the result of XORing bit 5 of the location counter and bit 5 of 
the address field value must be non-zero. (Otherwise the address without index modification was in a 
different page than the location counter, and the line is flagged with a B For bank error). 


Example: 


Flag 

Location 

Object 

Value 

Tag 

Source Statement 

Page 

Addressing 





.ABSP 




00000 

210001 


LAC 

A,X 

/Page 0 


00001 

740000 

A 

NOP 



10000 



• LOG 

10000 

/Page 1 


10000 

210001 


LAC 

B,X 

B 

10001 

210001 

B 

LAC 

.END 

A,X 



The result of statement evaluation has produced the following results: 

A, X- 10001 A = 00001 

B, X = 00001 B = 10001 
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Note that when index register usage Is specified, the index register bit may or may not be on. For B,X above, 
the index register bit was turned off during statement evaluation* The Assembler turns this bit on after the word 
is evaluated, not at statement evaluation time* 

At location 10001, the result of XORing bit 5 of A,X and bit 5 of the location counter is 0, This signals the 
Assembler that the address reference (A) is in a different page. 

b. If index register usage is not specified and the program is not assembled in bank mode*, the result 
of XORing bit 5 of the location counter and the address field value must be 0, otherwise the line is 
flagged with a B for bank error. 


Example: 


Flag 

Location 

Object 

Value 

Tag 

Source Statement 





.ABSP 

B 

00000 

10500 

210500 


LAC A 
.LOG 10500 


10500 

740000 

A 

NOP 

.END 


c. The bank bits (3,4) of the address field value in a relocatable program must never be on. The bank 
bits are always lost when the address field value and the operation are combined to form the object word 
value. 

Example: 


Flag 

Locati 

on 

Object 

Value 

Tag 

Source Statement 

B 

00000 

R 

200000 R 

C 

LAC A /Bank bit lost 


17777 

R 



. LOC C+17777 


17777 

R 

740000 A 


NOP 


20000 

R 

740000 A 

A 

NOP 






.END 


d. The bank bits of an absolute program must equal the bank bits of the location counter. If nof, 
the B flag alerts the programmer that he is referencing another bank. 


Example: 


Line 

Flag 

Location 

Object 

Value 

Source Statement 

1 




. ABSP 

2 


20000 


• LOC 20000 

3 


20000 

200001 

LAC 1 

4 


20001 

200001 

LAC 20001 

5 

B 

20002 

210001 

LAC 40001 

6 


I 







.END 


See pseudo-ops .ABS, .ABSP, .FULL, .FULLP, .EBREL, .DBREL 
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The address value for Lines 3 and 4 are identical. The bank bits of Line 5 do not match those of the location 
counter, therefore, the line is flagged. 


2.6.3 Word Evaluation of the Special Cases 


a. LAW - The operation field value and the address field value are combined as follows: 

Operation Value + (Address Field Value & 17777) - Word Value 
A validity check is then performed on the address field value as follows: 

Address Field Value & 760000 = Validity Bits 

If the validity bits are not equal to 760000 or 0, the line is flagged with an E to signal erroneous results. 

b. AAC, AXR, AXS - The operation field value and the address field value are combined as 
fol lows. 

Operation Value + (Address Field Value & 000777) = Word Value 
The validity check: 

Address Field Value & 777000 = Validity Bits 


If the validity bits are not equal to 777000 or 0 f the line is flagged with an E to signal erroneous 
results. The address field value for this type of instruction cannot be relocated. The line is flagged 
with an R if the address field value is relocatable. 

c. EAE class instructions - The operation field value and the address field value are combined as 
fol lows; 


Operation Value + Address Field Value = Word Value 

A validity check is then performed on the word value. If the operation code bits (0 through 3) o the 
word value differ from those of the operation value, the line is flagged with an E error to signal 
erroneous results. 
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Example: 


Line 

Flag 

Location 

Object 
Word Value 


1 


0 

777777 

LAW 

17777 

/I7777 

2 


1 

777777 

LAW 

-1 

/777777 

3 

E 

2 

777777 

LAW 

677777 

/677777 

4 


3 

760000 

A LAW 


/o 

5 


4 

723776 

AAC 

-2 

/77717b 

6 

E 

5 

723000 

AAC 

-2000 

/77b 000 


If numbers are found in the operation and address fields, they are combined in the same manner as defined 
symbols. For example, 

H 2 H5 H/GENERATES 000007 

The value of a symbol depends on whether it is in the label field, the operation field, or the address field„ The 
Assembler attempts to evaluate each symbol by running down a priority list, depending on the field, as shown 
below. 

2.6.4 Assembler Priority List 


Label Field 


Operation Field 


Address Field 

Current Value of 

1. 

Pseudo-op 

i. 

The indexing symbol, X 

Location Counter 

2. 

User macro in user symbol 
table 

2. 

User symbol table (including 

direct assignments) 


3. 

System macro table 



4. 

Direct assignment in user 
symbol table 

3. 

Undefined 


5. 

Permanent symbol table 




6. 

User symbol table 




7. 

Undefined 




This means that if a symbol is used in the address field, it must be defined in the user's symbol table before the 
word is formed during PASS 2; otherwise, it is undefined. (See section 2„2 0 4) 

In the operation field, pseudo-ops take precedence and may not be redefined. Direct assignments allow the 
user to redefine machine op codes, as shown in the example below. 

Example: 

DPOSIT = DAC 

System macros may be redefined as user macro names, but may not be redefined as user symbols by direct assign 
ment or by use as statement labels. 


The user may use machine instruction codes and MACRO-15 pseudo-op codes in the label field and refer to them 
later in the address field. 
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CHAPTER 3 
PSEUDO OPERATIONS 


In the discussion of symbols in the previous chapter, it was mentioned that the Assembler has in its permanent 
symbol table definitions of the symbols for all the PDP-15 memory reference instructions, operate instructions, 
the basic EAE instructions, and many commonly used IOT instructions which may be used in the operation field 
without prior definition by the user. Also contained in the permanent symbol table are a class of symbols called 
pseudo-operations (pseudo-ops) which, instead of generating instructions, generate data or direct the Assembler 
on how to proceed with the assembly. 

By convention, the first character of every psuedo-op symbol is a period (.). This convention is used in an at¬ 
tempt to prevent the programmer from inadvertently using, in the operation field, a pseudo-instruction symbol 
as one of his own. 


The following is a summary of MACRO-15 Pseudo-ops. 


Pseudo-op 

Section 

Function 

.ABS 

.ABSP 

3.2.1 

3.2.1 

Object program is output in absolute, blocked, checksummed format for 
loading by the Absolute Binary Loader. (Neither supported with RSX 

PLUS, RSX PLUS III or B/F MACROA.) 

.ASCII 

3.8.1 

Input text strings in 7-bit ASCII code, with the first character serving as 
delimiter. Octal codes for nonprinting control characters are enclosed in 
angle brackets. 

.BLOCK 

3.5 

Reserves a block o." storage words equal to the expression. If a label is 
used, it references the first word in the block. 

.CBD 

.CBDR 

3.18 

3.19 

Common Block Definition (DOS-15, RSX PLUS and RSX PLUS III only^ . 
Common Block Definition Relative (RSX PLUS and RSX PLUS III only). 

.DBREL 

3.2.3 

Disable bank mode relocation. 

.DEC 

3.4 

Sets prevailing radix to decimal . 

.DEFIN 

3.16 

Defines macros. Not supported with B/F MACROA. 

.DSA 

3.11 

Generates a transfer vector for the specified symbol* 

.EBREL 

3.2.3 

Enable bank mode relocation. 

.EJECT 

3.14 

Skip to head of form on listing device. 

.END 

3.6 

Must terminate every source program. The address field contains the address 
of the first instruction to be executed. 

. ENDC 

3.13 

Terminates conditional coding in .IF statements. 
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Pseudo-op 

Section 

Function 

.ENDM 

3.16 

Terminates the body of a macro definition. Not supported by B/F MACRO 

.EOT 

3.7 

Must terminate physical program segments, except the last, which is 
terminated by .END. 

.ETC 

3.16 

Used in macro definitions to continue the list of dummy arguments on 
succeeding lines. Not supported by B/F MACROA. 

.FULL 

.FULLP 

3.2.2 

Produces absolute, unblocked, unchecksummed binary object programs. 
Used only for paper tape output, (Neither supported with RSX PLUS, RSX 
PLUS III or B/F MACROA,) 

.GLOBL 

3.9 

Used to declare all internal and external symbols which reference other 
programs, 

. IFxxx 

3.13 

If a condition is satisfied, the source coding following the .IF statement 
and terminating with an .ENDC statement is assembled. 

. IODEV 

3.10 

Specifies .DAT slots and associated I/O handlers required by this program. 
(Not supported with RSX PLUS .) 

.LOC 

3.3 

Sets the location counter to the value of the expression. 

.LOCAL 

3.2.4 

Allows deletion of certain symbols from the user symbol table. 

. LST 

3.17 

Continues requested assembly listing output of source lines. Lines between 
.NOLSF and .LST are not listed. 

.LTORG 

3.2.5 

Allows the user to specifically state where literals are to be stored. Not 
supported by B/F MACROA. 

.NDLOC 

3.2.4 

Terminates deletion of certain symbols from the user symbol table con¬ 
tained between .LOCAL and .NDLOC. 

.NOLST 

3.17 

Terminates requested assembly listing output of source lines of code con¬ 
tained between .NOLST and .LST . 

.OCT 

3.4 

Sets the prevailing radix to octal . Assumed at start of every program. 

.REPT 

3.12 

Repeats the object code of the next object code generating instruction , 

Not supported by B/F MACROA. 

.SIXBT 

3.8.2 

Input text strings in 6-bit trimmed ASCII with first character as delimiter. 

.SIZE 

3.15 

MACRO-15 outputs the address of last location plus the one occupied 
by the object program. 

.TITLE 

3.1 

Causes the assembler to accept characters to be printed at the top of each 
page of assembly listing and in the Table of Contents. 


3,1 PROGRAM IDENTIFICATION (.TITLE) 

The program name (or any text) may be written in a .TITLE statement as shown in the following examples. The 
Assembler will accept up to 50^ characters typed until a carriage return, A form feed is output to the 
listing when .TITLE is encountered in the source program. The text will appear at the top of each form 
(page) until the next „TITLE pseudo-op. The ,TITLE pseudo-op has no effect on the listing file name, 

H.TITLE^ name of program 

H-TITLE u NAME OF SUBSECTION IN PROGRAM 

If subsections in a program are headed by .TITLE statements, these can be used to produce a table of contents 
at the head of the assembly listing by use of the T option. This feature is not available in ADSS-15 and Back¬ 
ground/Foreground . 
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3.2 OBJECT PROGRAM OUTPUT 


The normal object code produced by MACRO-15 is relocatable binary which is loaded at run time by the Linking 
Loader or loaded to build an executable task by CHAIN or TKB- In addition to relocatable output, the user may 
specify other types of output code to be generated by the Assembler. 

3.2.1 .ABSP, .ABS (Not available in RSX PLUS, RSX PLUS III or B/F MACROA)* 


Label Field 

Operation Field 

Address Field 

Not used 

Not used 

.ABSP 

.ABS 

--- 

NLD or u or not specified 

NLD armor not specified 


Both of the absolute pseudo-ops cause absolute, checksummed binary code to be output (no values are relocatable). 
If no value is specified in the address field and if the output device is the paper tape punch, the Assembler will 
precede the output with the Absolute Binary Loader (ABL), which will load the punched output at object time. 

The ABL is loaded, via hardware readin, into location 17720 of any memory bank. (The ABL loads only the 
paper tape which follows it.) If the address field of the pseudo-op contains NLD, indicating "no loader 1 ', the ABL 
will not precede the output. 


17720 

.ABS 

LOADER 

A 


USER PROGRAM 



.END START 

J 




PAPER TAPE 


NOTE 

.ABS (P) output can be written on directoried devices. 
The Assembler assumes .ABS (P) NLD for all .ABS (P) 
output to fi le-oriented devices and appends an exten¬ 
sion of ABS to the filename. This file can be punched 

with PIP, using Dump Mode. (There will be no abso¬ 
lute loader at the beginning of the tape.) 


a. The .ABS, .ABSP, .FULL, and .FULLP pseudo-ops, specifying the type of output, must 
appear before any statements generating object code, otherwise the line will be flagged 
and ignored. Once one of these four pseudo-ops is specified, the user is not allowed to 
change output modes. 

b. The NLD option provided in the address field of .ABS and .ABSP is meaningful only if the 
output device is paper tape. 


.ABSP and .ABS, although accepted by the Assembler, will not work properly in RSX PLUS or RSX PLUS III 
systems because none of the I/O handlers accept dump mode data. 





A description of the absolute output format follows* 

Block Heading - (three binary words) 

WORD 1 Starting address to load the block body which follows. 

WORD 2 Number of words in the block body (two's complement), 

WORD 3 Checksum of block body (two's complement). Checksum 
includes Word 1 and Word 2 of the block heading. 

Block Body - (n binary words) 

The block body contains the binary data to be loaded under block heading control. 

Starting Block - (two binary words) 

WORD 1 Location to start execution of program. It is distinguished from the block 
heading by having bit 0 set to 1 (negative), 

WORD 2 Dummy word. 

If the user requests the absolute loader and the value of the expression of the .END statement is equal to 0, the 
ABL halts after it has loaded in the object program. To start the program the user must set the starting address in 
the console address switches and press START. This allows manual intervention by the user, typically to ready 
I/O devices prior to starting his program. If the value of the .END expression is non-zero, it is treated as the 
program start address to which the ABL will automatically transfer control after loading the object program. 

The e ABSP pseudo-op causes all memory referencing instructions whose addresses are in a different page to 
be flagged as bank errors, A DBA instruction is executed by the absolute loader before control is given to 
the user program. Word values which have bit 5 on will signal the processor to use the index register to 
compute effective addresses. 

The ,ABS pseudo-op does not flag memory referencing instructions whose addresses are in a different page. An 
EBA instruction is executed, and control is given to the user in bank addressing mode. Complete bank addressing 
of 8K is allowed. The processor will interpret bit 5 of all memory referencing instructions as the high order 
address bit. A listing of the Absolute Binary Loader is given in Appendix F . 

3.2.2 .FULL, .FULLP (Not available in RSX PLUS, RSX PLUS 111 or B/F MACRO A)* 


Label Field 

Operation Field 

Address Field 

(Only useful 
if output 

Not used 

.FULL 

Not used 

is paper 

Not used 

.FULLP 

Not used 

tape) 


The .FULL and .FULLP pseudo-ops cause full binary mode output to be produced. The program is assembled as 
unchecksummed absolute code and each physical record of output contains nothing other than 18-bit binary 
storage words generated by the Assembler. This mode is used to produce paper tapes which can be loaded via 
hardware readin mode. If no address is specified in the .END statement or if the address value is zero, at the 

*.FULL and .FULLP, although accepted by the Assembler, will not work properly in RSX PLUS or RSX PLUS III 
systems because none of the I/O handlers accept dump mode data. 
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end of tape the assembler wi 11 punch a halt instruction with channel 7 punched in the third frame* If the .END 
address value is non-zero, the assembler will punch a JMP to that address, also with channel 7 of the third 
frame punched* 

In addition, with .FULLP assembly direct memory references in page 1 to addresses in page 1 will have bit 5 
set to 0 unless indexing is specified* 

The only difference between the .FULL and .FULLP pseudo-ops is that memory references across page boundaries 
are flagged in .FULLP mode; in .FULL mode they are-not. 

The following specific restrictions apply to programs assembled in e FULL or .FULLP mode output. 

»LOC Should be used only at the beginning of the program 

.BLOCK May be used only If no literals appear in the program, and must 

immediately precede .END. 

Variables and undefined symbols may be used if no literals appear in the program. 

Literals may be used only if the program has no variables and undefined symbols. 

The reason for these restrictions, not alleviated by the use of .LTORG, is the fact that .FULL(P) mode output 
contains no addressing information for storing binary words other than in sequence. The s LOC and .BLOCK 
pseudo-ops do not generate binary output, hence there is no way to indicate skipped locations in the output. 

This is also true of variables and undefined symbols. 

3.2.3 .EBREL and .DBREL 


Label Field 

Operation Field 

Address Field 

Not used 

.EBREL 

Not used 

Not used 

.DBREL 

Not used 


The following two pseudo-ops (.EBREL and .DBREL) enable relocation mode switching. They can be used any¬ 
where and as often as the programmer wishes in a relocatable program. In the absence of one of these mode 
declaration pseudo-ops, the page mode assembler assumes it is assembling 12-bit (page mode) relocatable ad¬ 
dresses for memory reference instructions and the bank mode assembler assumes 13-bit addresses (bank mode). 

A typical user program may omit the use of these pseudo—ops and simply prepare his object code by using the 
correct (bank or page mode) version of the assembler. For the PDP—9 there is only one correct mode, bank mode. 
For PDP-15 page mode programs which contain display code to be interpreted by the VT15 graphics processor, 
it is necessary to bracket the display code with .EBREL, .DBREL. Unlike the Central Processor, the VT15 proc¬ 
essor runs only in bank mode; hence its instruction addresses must be relocated as 13-bit values. 


3-5 





Mnemonic 


Description 


.EBREL Enable Bank mode RELocation 

Regardless of the type of Assembler being used (bank or page mode version), 
.EBREL causes all subsequent memory reference instruction addresses to be 
treated as 13-bit values, i.e., bank mode. Although in this mode, the page 
mode assembler will still output the "PROG>4K" warning message if the pro¬ 
gram size exceeds 4192. The 12- or 13-bit relocation is performed by the 
loaders. .EBREL signals the loaders to switch to 13-bit relocation by causing 
a dummy data word (which is not loaded) to be inserted in the binary output 
and having a loader code of 31 g. 

.DBREL Disable Bank mode RELocation 

.DBREL is the counterpart to .EBREL. It signals the loaders, with a dummy 

data word and loader code of 32 to switch to 12-bit (page mode) relocation. 

o 

NOTE 

The previous mode is not saved when an * EBREL or .DBREL 
is encountered; for this reason, a .DBREL pseudo-op goes 
directly to PDP-15 (page mode) relocation rather than 
entering the previous mode. 

3.2.4 Deletion of User Symbol Table (.LOCAL, .NDLOC) 


Label Field 

Operation Field 

Address Field 

Not used 

.LOCAL 

Not used 

Not used 

.NDLOC 

Not used 


The size of a program that can be assembled with MACRO-15 is determined by the number of user symbols in 
that program and therefore by the amount of core available at assembly time in which to store those symbols. 

Each user symbol requires three words of core in the assembler's symbol table @ This additional core is not 
required at run-time (unless using a debugging program like DDT) because user symbols are not loaded into 
core along with the object code * 

The .LOCAL and .NDLOC pseudo-ops enable deletion of certain symbols from the user symbol table, in so 
doing, larger programs can be assembled without increasing core size. The area between these two pseudo-ops 
is defined as having a number of symbols, most of which are used only in this area and which can be deleted, once 
this area has been passed by the assembler. The 8K PDP-15 user who writes modularized programs will find these 
pseudo-ops to be very powerful tools. 

The assembler creates a separate symbol table (local users symbol table) when the .LOCAL pseudo-op is encoun¬ 
tered. Only tags and direct assignments may be stored in this table. Tag symbols which have the ^ sign as part 
of the symbol are stored in the resident users symbol table (RUST). This feature is useful where a subroutine name 
is part of a local area but must go into the RUST because of subroutine calls from without the local area (See 
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Section D of the following example). Symbols which are forward references (used before defined) are stored as 
part of the resident users symbol table. When the .NDLOC pseudo-op is encountered the local table disappears 
and the resident UST is left unchanged. 


An example of a program which uses the .LOCAL and .NDLOC pseudo-ops follows. The symbols that are stored 
in the tables are represented in the comment field in the order that they are stored during PASS 1. 


1 


.ABS 



2 


.LOC 

100 


3 


CAF 



4 


JMS 

TTYIN 

AT YIN 

5 

A 

JMP 

c 

/C, A 

6 


LAW 

-10 


7 


DAC 

D 

/D 

8 

KK 

ISZ 

D 

/KK 

9 


JMP 

A 


10 


LAC 

KK 


11 


JMP 

AA 

/AA 

12 


. LOCAL 



13 

TTYIN 

0 


/ALREADY STORED IN RUST (FROM LINE 4) 

14 


JMP 

.+5 


15 

XXX 

0 


AEMP STORAGE OF SUBR. TTYIN: XXX(LOCAL TABLE) 

16 

YY 

0 


/ Y (LOCAL TABLE) 

17 

Z 

0 


/ Z (LOCAL TABLE) 

18 

XI 

0 


/ XI (LOCAL TABLE) 

19 


KSF 



20 


JMP 

.-1 


21 


KRB 



22 


DAC 

XXX 


23 


DAC 

YY 


24 


DAC 

Z 


25 


DAC 

XI 


26 


JMP* 

TTYIN 


27 


.NDLOC 



28 

AA 

LAC 

XI 

/XI,(FORWARD REF. LOCAL TABLE DISAPPEARED). 

29 


JMP 

KK 


30 


. LOCAL 



31 

SYM1 



AEMP STORAGE OF SUBR. TSUBR SYM1 (LOCAL 





AABLE) 

32 

SYM2 



/ SYM2 (LOCAL TABLE) 

33 

TSUBR# 

0 


ASUBR STORED IN RUST BECAUSE OF # SIGN. 

34 


LAC 

SYM1 


35 


DAC 

SYM2 


36 


JMP* 

TSUBR 



37 .NDLOC 

38 .END 
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For purposes of illustration, lines 1-11, 12-26, 27-29, and 30-36 are broken into sections A, B, C, and D 
respectively. The following tables show the resident and local users symbol tables (UST) at the end of each section 
(PASS 1 only). 


RESIDENT UST 
SECTION A 
A 

AA 

C 

D 

KK 

TTYIN 
SECTION B 
A 

AA 

C 

D 

KK 

TTYIN 
SECTION C 
A 

AA 

C 

D 

KK 

TTYIN 

XI 

SECTION D 
A 

AA 

C 

D 

KK 

TTYIN 

XI 

TSUBR 


LOCAL UST 


(NO SYMBOLS) 


X 

XI 

Y 

Z 


(NO SYMBOLS) 


SYM1 

SYM2 


In Section A, the symbol TTYIN is used. TTYIN is in a local area yet it is put into the resident user symbol 
table because it is a forward reference. The same is true of symbol XI from Section C. Once the .NDLOC 
pseudo-op is encountered, the local UST no longer exists. For that reason, the XI reference from line 28 is a 
forward reference. At the end of PASS 1, XI would be represented as an undefined symbol. When Section B 
is processed during PASS 2, the symbol XI would not be stored in the local UST because it already has been 
put into the resident table. 
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LIMITATIONS 


A. The .LOCAL pseudo-op causes the local UST to be built just above the Macro definitions. 
Consequently, the .DEFIN Macro is illegal In a local area. 

B. In systems with an extra 4K of core (12K, 20K and 28K) no attempt is made to continue the 
local users symbol table from low core to the extra page. The housekeeping code that would 
be needed to do this would negate the utility of the .LOCAL pseudo-op. The likelihood of 
such an occurrence is small. However, should the table reach the beginning of the Assembler, 
assembly will terminate with the message 

TABLE OVERFLOW 

3.2.5 Literal Origin Pseudo-op (. LTORG) (Not available in B/F MACROA) 


Label Field 

Operation Field 

Address Field 

Not used 

. LTORG 

Not used 


As previously stated, a literal is an item of data with its value as stated or listed. The pseudo-op .LTORG al¬ 
lows the user to specifically state where he wants his literal table(s) to be stored; thus enabling the user to store 
literal tables in different pages or banks. As many as eight literal tables are allowed. Notice in the following 
example that literals are not saved from one .LTORG to the next. 






.ABS 






.LOG 

17700 


17700 

217703 


LAC 

(1 


17701 

077704 


DAC* 

(2 


17702 

217704 


LAC 

(3 





.LOC 

20000 





.LTORG 



20000 

000001 

*L 




20001 

000002 

*L 




20002 

000003 

*L 







.LOC 

17703 


17703 

740000 


NOP 



17704 

217711 


LAC 

0 


17705 

057712 


DAC 

(2 





.LOC 

20003 

- 




.LTORG 



20003 

000001 

*L 




20004 

000002 

*L 







.END 



The literals 1 and 2 

are stored twice even 

though they 

appear in the same bank. 



If more than eight .LTORG statements appear in a program, the excess ones will be ignored and flagged with an 
I error. Subsequent literals will be assigned core locations fol lowing the end of the program in the normal manner. 
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3.3 SETTING THE LOCATION COUNTER (.LOC) 


Label Field 

Operation Field 

Address Field 

Not used 

.LOC 

Predefined symbolic 
expression, or number 


The . LOC pseudo-op sets or resets the location counter to the value of the expression contained in the address 
field. The symbolic elements of the expression must have been defined previously; otherwise, phase errors will 
occur in PASS 2. The . LOC pseudo-op may be used anywhere and as many times as required. 

Examples: 


Location Counter 

Instruction 

100 

H .LOC^100 

100 

H LAC^ TAG 1 

101 

H DAC t _ I TAG2 

102 

H -LOC^. 

102 

AH LACjjB 

103 

H dac^c 

107 

H -loc^a+5 

107 

H LAC^C 

no 

H dac^d 

111 

H lac^e 

112 

Hdac^f 


A program headed by an absolute statement, e.g., .LOC 100 is an absolute binary program and the binary is 
output in link-loadable format. 

3.4 RADIX CONTROL (.OCT and .DEC) 

The initial radix (base) used in all number interpretation by the Assembler is octal (base 8). In order to allow 
the user to express decimal values, and then restore to octal values, two radix setting pseudo-ops are provided 


Pseudo-op Code 

Meaning 

.OCT 

.DEC 

Interpret all succeeding numerical values in base 8 (octal) 

Interpret all succeeding numerical values in base 10 (decimal) 
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These pseudo-instructions must be coded in the operation field of a statement* AM numbers are decoded in the 
current radix until a new radix control pseudo-instruction is encountered unless the pseudo-op occurs within a 
MACRO expansion (see p. 4-4), The programmer may change the radix at any point in a program. 


Flag 

Source Program 

Generated Value (Octal) 

Radix in Effect 


H LAC 100 

200100 

8 ^ initial value is 


H 25 

000025 

8 J assumed to be octal 


H .DEC 




H LAC 100 

200144 

10 


Flag 

Source Program 

Generated Value (Octal) 

Radix in Effect 


H 275 

000423 

10 


H .OCT 




H 76 

000076 

8 

N 

H 85 


error 


If a number is encountered which contains a decimal digit while in octal mode, the number is evaluated as if the 
Assembler were in decimal mode, and the line is flagged with an N, 

3,5 RESERVING BLOCKS OF STORAGE (.BLOCK) 


.BLOCK reserves a block of memory equal to the value of the expression contained in the address field. If the 

address field contains a numerical value, it will be evaluated according to the radix in effect. The symbolic 

elements of the expression must have been defined previously, i 8 e,, no forward referencing is allowed; otherwise, 

1 5 

phase errors might occur in PASS 2. The expression is evaluated modulo 2 (77777 ). The user may reference 

8 

the first location in the block of reserved memory by defining a symbol in the label field. The initial contents of 
the reserved locations are unspecified. 


Label Field 

Operation Field 

Address Field 

User Symbol 

.BLOCK 

Predefined Expression 


Examples: 


BUFF H .BLOCK 1 _ J 12j 

H .BLOCK^A+B+65^ 

3.6 PROGRAM TERMINATION (.END) 

One pseudo-op must be Included in every MACRO-15 source program. This is the .END statement, which must 

be the last statement in the main program. This statement marks the physical end of the source program, and also 
may contain the location of the first instruction in the object program to be executed at run-time. 
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The . END statement is written in the general form 
H . ENDSTART ) 

START may be a symbol, number, or expression whose value is the address of the first program instruction to be 
executed 0 In relocatable programs to be loaded by the Linking Loader, CHAIN or TKB, only the main 
program requires a starting address; all other subprogram starting adresses, if specified, will be ignored, 

A starting address must appear in absolute or self-loading programs; otherwise, the program will halt after being 
loaded and the user must manually start his program. 


These are legal .END statements 

H .END^.BEGIN + 5 ) 

H • END l __ 1 200^ 

If no .END statement is included (or no tab or space precedes the , END) the assembler will treat it as if a .EOT 
was included® 


3.7 PROGRAM SEGMENTS (.EOT) 

If a program is physically segmented (on paper tape, DEC tape or magtape), each segment except the last may 
terminate with an .EOT (end-of-tape) statement or with nothing at all (neither .EOT nor .END), Termination 
with nothing is equivalent to termination with .EOT. The last segment must terminate with an .END statement. 
The .EOT statement is written without label and address fields, as follows, 

-H .EOT ) 

The following are typical reasons for segmenting programs: 

1 , A source program is prepared on three different paper tapes because one tape alone would be 
too large to fit in the reader. 

2. A source program is split in two and stored on two DEC tapes because it is larger than the 

capacity of a single tape. 

3. To simplify program preparation, a file containing commonly used macro definitions is kept 
physically separate from user main programs. Thus, one does not have to include the macro 
definitions in each main program. Macro definition files must terminate with .EOT or 
nothing rather than .END. 

4. Programs can be conditionally assembled for different machine configurations or different soft¬ 
ware options. This is done by defining conditional assembly parameters at assembly time. 

The process can be simplified if one prepares paper tapes or mass storage files defining all 
parameters for a given set of options. The main program and parameter file are physically 
segmented one from the other but can be assembled together. Parameter definition files 
must terminate with .EOT or nothing rather than .END. 

3.8 TEXT HANDLING (.ASCII AND .SIXBT) 

The two text handling pseudo-ops enable the user to represent the 7-bit ASCII or 6-bit trimmed ASCII character 
sets. The Assembler converts the desired character set to its appropriate numerical equivalent (see Appendix A), 
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Label Field 

Operation Field 

Address Field 

SYMBOL 

{ 

r .ASCII ^ 

. SIXBT 


Delimiter - character string - delimiter - 

< expression >. 


Only the 64 printing characters (including space) may be used in the text pseudo-instructions. See nonprinting 
characters. Section 3*8*5 e The numerical values generated by the text pseudo-ops are left-justified in the 
storage word(s) they occupy with the unused portion (bits) of a word filled with zeros. 


3*8 J oASCH Pseudo-op 


’ASCII denotes 7-bit ASCII characters, (It is the character set used by the operating system monitor 
or executive„) The characters are packed five per two words of memory with the rightmost bit of every 
second word set to zero* An even number of words will always be output: 


First Word 

Second Word 

o 6 7 13 14 17 

0 2 3 9 10 16 17 

1st Char. 

2nd Char. 

3rd Char. 

4th Char. 

5th Char. 

0 


3.8.2 .SIXBT Pseudo-op 


.SIXBT denotes 6-bit trimmed ASCII characters, which are formed by truncating the leftmost bit of the 
corresponding 7-bit character. Characters are packed three per storage word. 


0 5 

6 11 

12 17 

1st Char. 

2nd Char. 

3rd Char. 


3.8.3 Text Statement Format 

The statement format is the same for both of the text pseudo-ops. The format is as follows. 

< expression >. 


f.ASClfl , 




{. SIXBT] H 

del i mi ter 

character string 

delimiter 


3.8.4 Text Delimiter 


Spaces or tabs prior to the first text delimiter or angle bracket (<C) will be ignored; afterwards, if they are not 
enclosed by delimiters or angle brackets, they will terminate the pseudo-instruction. Also, ) will terminate 
the pseudo-instruction. 


Any printing character may be used as the text delimiter, except those listed below. 

a. < as it Is used to indicate the start of an expression. 

b. J as it terminates the pseudo-instruction. 
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(The apostrophe ( 1 ) is the recommended text delimiting character.) The text delimiter must be present on both 
the left-hand and the right-hand sides of the text string; otherwise, the user may get more characters than de¬ 
sired. However,^) may be used to terminate the pseudo-instruction. 


3.8.5 Non-Printing Characters 

The octal codes for non-printing characters may be entered in .ASCII statements by enclosing them in angle 
bracket delimiters. In the following statement, five characters are stored in two storage words. 

H .ASCII i_i' AB' <015 > 1 CD 'J 

Octal numbers enclosed in angle brackets will be truncated to 7 bits (.ASCII) or 6 bits (.SIXBT). 


Example: 


Source Line 

Recognized Text 

Comments 

TAGH .ASCII u'ABC' 

ABC 


H .SIXBT,_,/ABC' 

ABC 


H . SIXBT 1 _ 1 'ABC , # , / fl 

ABC'/ 

The ^ is used as a delimiter in order 
that ( 1 ) may be interpreted as text. 

H .ASCII uj'ABCD'EFGE 

ABCDFG 


-1 . ASCIIs 'AB'<11> 

AB H 

<11> used to represent tab. 

H .ASCII 1 _ J 'AB<11> 

AB<11> 

There is no delimiter after B, 
therefore, (<11>) is treated as text. 

H .ASCIIs_j<15><012>'ABC 

ABC 


H .ASCII i _ 1 <15><12>ABC 6 __ 1 (s) 

) *BC 1 _ l (s) 

A is interpreted as the text delimiter. 
Also, since J was not used to ter¬ 
minate the text, the „ 4s) are inter¬ 

preted as text characters. 


The following example shows the binary word format which MACRO-15 generates for a given line of text. 


Example: 


H .ASCII H 'ABC'<015><12>'DEF 1 


Generated Coding 


Word Number 

Octal 

Binary 

Word 1 

Word 2 

Word 3 

Word 4 

406050 

306424 

422130 
600000 

100000I 

1000010 

1000 

on 

0001101 

0001010 

0 

1000100 

1000101 

1000 

110 

0000000 

0000000 

0 
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3.9 GLOBAL SYMBOL DECLARATION (.GLOBL) 


Label Field 

Operation Field 

Address Field 

Not used 

.GLOBL 

A,B, C,D,E.... 


The standard output of the Assembler is a relocatable object program * The Linking Loader, CHAIN or TKB 
joins relocatable programs by supplying definitions for global symbols which are referenced in one program and 
defined in another* The pseudo-op e GLOBL, followed by a list of symbols, is used to define to the Assembler 
those global symbols which are either 

a. internal globals - defined in the current program and referenced by other programs 
b 8 external symbols - referenced in the current program and defined in another program 

The loader (Linking Loader, CHAIN or TKB) uses this information to include in the load and then link the relo¬ 
catable programs to each other. 

All references to external symbols must be indirect references since PDP-1 5 software systems use transfer vec¬ 
tors for referencing external symbols. Each external symbol causes an additional word (the transfer vector 
word) to be reserved in the user program. The loading program will store the actual address of the externa! 
symbol in the transfer vector word. Thus, an indirect reference (through the transfer vector) will cause the 
external symbol location to be addressed. 

Example: 

.GLOBL -*| A,B,C 
A LAC D 

D H JMS* H B 

H jms* H c 

.END D 

The .GLOBL statement may appear anywhere within the program. 

The example above is assembled as follows: 


Flag 

Location 

Word Value 

.GLOBL A,B,C 


000000 R 
000001 R 
000002 R 

000003 R 
000004 R 

200001 R 
120003 R 
120004 R 
000001 

000003 *E 
000004 *E 

A LAC D 

D JMS* B 

JMS* C 
.END D 


The real values for locations 3 and 4 will be supplied by the loading program: these two words will contain 
the addresses in memory of external symbols B and C. 


/A is an internal global 

'These two instructions reference 
/External symbols indirectly 
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3JO REQUESTING I/O DEVICES (JODEV) (not supported in RSX) 

The JODEV pseudo-op appears anywhere in the program (though standardly near the beginning) and is used to 
cause the Assembler to output code for the Linking Loader or CHAIN which specifies the slots in the Monitor’s 
device assignment table (DAT) whose associated device handlers are required by the program„ This is used in 
those systems where device handlers are brought into core at the time a program is loaded to run. 


Label Field 

Operation Field 

Address Field 

Not used 

. IODEV 

1,2,3... 


The arguments may be numeric or symbolic. If the argument is symbolic, the symbol must be defined by a direct 
assignment statement. 

3 J 1 DESIGNATING A SYMBOLIC ADDRESS (,DSA) 

*DSA (designate symbol address) is used in the operation field when it is desired to create a word composed of 
just a transfer vector (15-bit address). It is useful when a user tag symbol is also a permanent instruction or 
pseudo-op symbol. 


Label Field 

Operation Field 

Address Field 

User Symbol 

.DSA 

Any Expression 


Examples: 

JMP ^ LAC H TAG 

H «DSA -*| JMP Equivalent methods of designating the user symbol JMP (rather than 

-*j JMP J the instruction JMP) to be in the address field. 

3 J 2 REPEATING OBJECT CODING (.REPT) (Not available in B/F MACROA) 


Label Field 

Operation Field 

Address Field 

Not used 

.REPT 

Count L Increment^ 

1 ° r v^ 

■ or v> 

__°2L. 


The .REPT pseudo-op causes the object code of the next sequential object code generating instruction to be 
repeated count 1 times. Optionally, the object code may be incremented for each time it is repeated by 
specifying an increment. The count and increment may be represented by a numeric or symbolic value. If a 
symbol is used, it must be defined by an absolute direct assignment statement which must occur before the sym¬ 
bol is used. The repeated instruction may contain a label, which will be associated with the first statement 
generated. Note that arithmetic expressions in the address field are illegal . 
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Examples: 


Source Code 

Generated 

Object Code 

H -REpt^s 


H o 

000000 


000000 


000000 


000000 


000000 

H • REPT 1 _ J 4,1 


H 1 

000001 


000002 


000003 


000004 

H • REPT|_j3,-l 


H 5 

000005 


000004 


000003 

TAG=50 


H .REPT ,4,1 

1 i—l 1 


H JMP^TAG 

600050 


600051 


600052 


600053 I 


NOTE 

If the statement to be repeated generates more than one 
location of code, the . REPT will repeat only the last lo¬ 
cation. For example, 

H .REPT^S 
H . ASCII ^ ‘A 1 

will generate the following: 

404000 5/7 A 

000000 

000000 last word is 
000000 repeated 




3.13 CONDITIONAL ASSEMBLY (.IF xxx and .ENDC) 

It is often useful to assembly some parts of the source program on an optional basis. This is done in MACRO"! 5 
by means of conditional assembly statements, of the form: 

H .IF... —®*j expression 

The pseudo-op may be any of the eight conditional pseudo-ops shown below, and the address field may contain 
any number, symbol, or expression. If there is a symbol, or an expression containing symbolic elements, such 
a symbol must have been previously defined in the source program or the parameter file (except for JFDEF and 
JFUND)* If not, the value of the symbol or expression is assumed to be J^, thereby satisfying three of the 
numeric conditionals. 

If the condition is satisfied, that part of the source program starting with the statement immediately following 
the conditional statement and up to but not including an .ENDC (end conditional) pseudo-op is assembled. If 
the condition is not satisfied, this coding is not assembled. 

The eight conditional pseudo-ops (sometimes called IF statements) and their meanings are shown below. 


Pseudo-op 

Assemble IF x is: 

H .IFPNZ^x 

Positive and non-zero 

H .IFNEG^x 

Negative 

H .IFZER^x 

Zero 

H -IFPOZ^x 

Positive or zero 

H . IFNOZ,_,x 

Negative or zero 

q .IFNZR^x 

Not zero 

H .IFDEF^x 

A defined symbol 

q .IFUND^x 

An undefined symbol 


In the following sequence, the pseudo-op .IFZER is satisfied, and the source program coding between .IFZER 
and .ENDC is assembled. 

SUBTOT=48 

TOTALL=48 

H .IFZER H SUBTOT-TOTALL 

H lac^a 
Hdac^b 
H .ENDC 

Conditional statements may be nested. For each IF statement there must be a terminating .ENDC statement. 
If the outermost IF statement is not satisfied, the entire group is not assembled. If the first IF is satisfied, the 
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following coding is assembled. If another IF is encountered, however, its condition is tested, and the following 
coding is assembled only if the second IF statement is satisfied. Logically, nested IF statements are like AND 
circuits. If the first, second, and third conditions are satisfied, then the coding that follows the third nested 
IF statement is assembled. 

Example: 


H 

.IFPOZ^X 

conditional 1 initiator 

H 

LAC H TAG 


H 

.IFNZR^Y 

conditional 2 initiator 

H 

DAC H TAG1 


H 

. ENDC 

conditional 2 terminator 

H 

.IFDEF e _ 5 Z 

conditional 3 initiator 


DACH TAG2 


H 

.ENDC 

conditional 3 terminator 

H 

.ENDC 

conditional 1 terminator 


Conditional statements can be used in a variety of ways. One of the most useful is in terminating recursive 
macro calls (described in Chapter 4). In general, a counter is changed each time through the loop, or recursive 
call, until the condition is not satisfied. This process concludes assembly of the loop or recursive call. 

3.14 LISTING CONTROL (.EJECT) 

The following Assembler listing control is effective only when a listing is requested by Assembler control key¬ 
board request. 


Label Field 

Operation Field 

Address Field 

Not used 

.EJECT 

Not used 


When .EJECT is encountered anywhere in the source program, it causes the listing device that is being used to 
skip to top-of-form. 

3.15 PROGRAM SIZE (.SIZE) 


Label Field 

Operation Field 

Address Field 

User Symbol 

.SIZE 

Not used 
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When the Assembler encounters .SIZE, it outputs one word which contains the address of the last location plus 
one occupied by the object program. This is normally the length of the object program (in octal). However, 
if a given program is 1 21 g words long and has a ,LOC 400 statement at the head of the program, the value of 
the .SIZE word will be 521 

3.16 DEFINING MACROS (.DEFIN, .ETC, and „ENDM) (Not available in B/F MACROA) 

The .DEFIN pseudo-op is used to define macros (described in Chapter 4). The address field in the .DEFIN 
statement contains the macro name, followed by a list of dummy arguments. If the list of dummy arguments will 
not fit on the same line as the .DEFIN pseudo-op, it may be continued by means of the .ETC pseudo-op in the 
operation field and additional arguments in the address field of the next line. The coding that is to constitute 
the body of the macro follows the .DEFIN statement. The body of the macro definition is terminated by an 
.ENDM pseudo-op in the operation field. (See Chapter 4 for more details on the use of macros.) 

3.17 ASSEMBLY LISTING OUTPUT CONTROL (.NOLST and .LST) 


Label Field 

Operation Field 

Address Field 

Not used 


f. NOLST] 
L. LST J 


Not used 


If, while performing an assembly listing operation (L, X, or N assembly parameters), the assembler encounters 
a .NOLST, the listing operation will be terminated until a .LST is found. These pseudo-ops are useful when 
the user wishes to assemble all of a program, but only needs a listing of certain modules of the program (e.g,, 
those which may not yet work properly). All symbols occurring between .NOLST and »LST will appear,in the 
cross reference and symbol fable listings when requested (A, V, X, or S assembly parameters). 

3.18 COMMON BLOCK DEFINITION (,CBD) (DOS and RSX Systems Only) 

The pseudo-op e CBD enables the programmer to declare a COMMON area of an indicated name and size and 
to specify the word to be set to its base address. The general format of this pseudo-op is: 


Label Field 

Operation Field 

Address Field 

User Symbol 

. CBD 

Name,_jSize 


The ,CBD pseudo-op takes a COMMON name and size as arguments, reserves one word of core for the base 
address, and outputs loader codes and parameters to direct the Linking Loader, CHAIN or TKB programs to set 
a transfer vector to the base address (first element) of the named COMMON array. For example, the statement 

BASE ,CBD ABCD 6 
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provides location BASE with the address of the first word of the COMMON area named ABCD whose size is 6. 
Blank COMMON is given a special name by the system software, .XX. To reference Blank COMMON in a 
.CBD statement, „XX should be given as the block name, 

3.19 COMMON BLOCK DEFINITION RELATIVE (.CBDR) (RSX Systems Only) 

The pseudo-operation .CBDR (common block definition relative) takes an offset as its only argument. The 
general format of this pseudo-op is: 


Label Field 

Operation Field 

Address Field 

User Symbol 

.CBDR 

Displacement 


This pseudo-op directs the task builder to enter the starting address of the last COMMON block specified in a 
.CBD plus the offset given in the .CBDR into the word corresponding to the location of the .CBDR. 

For example, the statements 

BASE .CBD ABCD 5 

BASES .CBDR 3 

will cause the task builder to enter the starting address of the COMMON block ABCD into the location corre¬ 
sponding to the tag BASE; in addition, the location corresponding to BASE3 will contain the starting address of 
ABCD plus 3, 

Note that .CBDR is relative to the last COMMON definition only. Any other assembler instructions or 
pseudo-operations may intervene between the .CBD and .CBDR. 








CHAPTER 4 
MACROS 


When a program is being written, it often happens that certain coding sequences are repeated several times with 
only the arguments changed. It would be convenient if the entire repeated sequence could be generated by a 
single statement. To accomplish this, it is first necessary to define the coding sequence with dummy arguments 
as a macro instruction, and then use a single statement referring to the macro name along with a list of real 
arguments which will replace the dummy arguments and generate the desired sequence. 

Consider the following coding sequence. 

H LAC H A 
H TAD H B 

H dacH c 

~*| LAC -*| D 
H TAD H E 

H dacH f 

The sequence 

-+| LAC “H x 
H TAD -*| y 
H DAC H z 

is the model upon which the repeated sequence is based. The characters x, y, and z are called dummy arguments 
and are identified as such by being listed immediately after the macro name when the macro instruction is 
defined. 

4.1 DEFINING A MACRO 

* 

Macros must be defined before they are used. The process of defining a macro is as follows. 
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(Definition Line) 
(Body) 

(Terminating Line) 


(Macro^Name) (Dummy Arguments) 

H .DEFIN H MACNME,ARGI^ARG2tARG3 -*j 
H LAC H ARG1 

H TAD H ARG2 

H DAC H ARG3 

H . ENDM 


/comment 


The pseudo-op .DEFIN in the operation field defines the symbol following it as the name of the macro. Next, 
follow the dummy arguments, as required, separated by commas and terminated by any of the following symbols. 


a. 

space 


b. 

fab 

H ) 

c. 

carriage return 

(J) 


The macro name and the dummy arguments must be legal MACRO-15 symbols. Any previous definition of a 
dummy argument is ignored while in a macro definition. Comments after the dummy argument list in a definition 
are legal. 

If the list of dummy arguments cannot fit on a single line (that is, if the .DEF1N statement requires more than 
7characters) it may be continued on the succeeding line or lines by the usage of the .ETC pseudo-op, as 
shown below. 


H DEFIN ^ MACNME,ARG 1 ,ARG2,ARG3 /comment 

H .ETC HARG4,ARG5 /argument continuation 

H .definH macnme 
H .ETC H ARGl 
H .ETC H ARG2 
H .ETC H ARG3 
H .ETC H ARG4 
H .ETC H ARG5 

4.2 MACRO BODY 

The body of the macro definition follows the .DEFIN statement. Appearances of dummy arguments are marked 
and the character string of the body is stored, five characters per two words in the macro definition table, until 
the macro terminating pseudo-op .ENDM is encountered. Comments within the macro definition are not stored. 

Dummy arguments may appear in the definition lines only as symbols or elements of an expression. They may 
appeal in the label field, operation field, or address field. Dummy arguments may appear within a literal or 
they may be defined as variables. They will not be recognized if they appear within a comment. 
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The following restrictions apply to the usage of the .DEFIN, .ETC and , ENDM pseudo-ops: 

a. If they appear in other than the operation field within the body of a macro definition, they will 
cause erroneous results, 

b. If .ENDM or .ETC appears outside the range of a macro definition, it will be flagged as undefined. 

If index register usage is desirable, it should be specified in the body of the definition, not in the argument 
string. 

.DEFIN XUSE, A, B,C 

LAC A 

DAC B,X 

LAC C 

.ENDM 

If .ASCII or .SIXBT is used in the body of a macro, a slash (/) or number sign (^) must not appear as part of the 
text string or as a delimiter (use < 57 > to represent a slash and <43 > to represent a number sign). Be careful 
when using a dummy argument name as part of the text string. For example, 

.DEFIN TEXT A 

.SIXBT , A, 

.SIXBT .A. 

.ENDM 

followed by the macro call, 

TEXT XYZ 

will generate the following code 

.SIXBT ,XYZ, 

.SIXBT .A. 

In the first .SIXBT statement, A is recognized as a dummy argument resulting in the substitution of XYZ. In the 
second statement, A is not recognized as a dummy argument because the string delimiter, period, is itself a legal 


symbol constituent. 






Definition Comments 

H 

.DEFIN 

H 

MAC, A, B, C, D, E, F 

H 

LAC 

H 

A# 

H 

SPA 



H 

JMP 

H 

B 

H 

ISZ 

H 

TMP H/E E is not recognized as an argument 

H 

LAC 

H 

(C 

H 

DAC 

H 

D + 1 

H 

F 



H 

.ASCII 

H 

E 

B=. 




H 

.ENDM 




4.3 MACRO CALLS 

A macro call consists of the macro name, which must be in the operation field, followed by a list of real argu¬ 
ments separated by commas and terminated by one of the characters listed below. 



a. 

space 


b. 

tab 

H ) 

c 9 

carriage return 

O) 


If the rea! arguments cannot fit on one line of coding, they may be continued on succeeding lines by terminating 
the current line with a dollar sign ($). When they are continued on succeeding lines they must start in the tag 
field. 


Example: 

H MACH REAL! ,REAL2,REAL3,$ 

REAL4,REAL5 

If there are n dummy arguments in the macro definition, all real arguments in the macro call beyond the nth 
dummy argument will be ignored. A macro call may have a label associated with it; this label will be assigned 
to the current value of the location counter. 


Example: 


(Definition) H .DEFIN H UPDATE,LOC,AMOUNT 
H LAC H LOC 

H TAD HAMOUNT 

H DAC H LOC 
H . ENDM 


(Call) 

TAGH UPDATE H CNTR, (5 

(Expansion) 

tagH LAC 

H CNTR 


H TAD 

H(5 


H DAC 

CNTR 


/TAG ENTERED INTO SYMBOL TABLE 

/WITH CURRENT VALUE OF LOCATION COUNTER 


The prevailing radix will be saved prior to expansion and restored after expansion takes place. Default as- 
sumption will be octal for the macro call. It Is not necessary for the macro definition to have any dummy argu¬ 
ments associated with it. 


Example: 

H .DEFIN, TWOS 
H CMA 

H tad^o 

H .ENDM 

(Cali) H TWOS 

(Expansion) H CMA 

H TAD 1 _i (1 
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4.3.1 Argument Delimiters 

It was stated that the list of arguments is terminated by any of the following symbols. 


space 


tab 

H ) 

carriage return 

(J) 


These characters may be used within real arguments only by enclosing them in angle brackets (<>)« Angle 
brackets are not recognized if they appear within a comment* 


Example: 


(Definition) -*| . DEFIN. „MAC, A,B,C 
H LAC^A 

H tad^b 
H DAC^C 
H .ENDM 

(Call) -*>| MAC. .TAG1,<TAG2 /comment 

H TAD | _ I (1)>,TAG3 
(Expansion) ^ LAC. .TAG! 

H TAD 1 _ J TAG2 
H TAD,_,(!) 

H DACjjTAGS 


All characters within a matching pair of angle brackets are considered to be one argument, and the entire argu¬ 
ment, with the delimiters (<>) removed, will be substituted for the dummy argument in the original definition. 

MACRO-15 recognizes the end of an argument only on seeing a terminating character not enclosed within angle 
brackets ■ 


If brackets appear within brackets, only the outermost pair is deleted. If angle brackets are required within a 
real argument, they must be enclosed by argument delimiter angle brackets. 

Example: 

(Definition) H -DEFIN H ERRMSG,TEXT 
H JMS H PRINT 
H .ASCII H TEXT 
H .ENDM 
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(Call) H ERRMSG H </ERROR IN LINE/ < 15» 

(Expansion) H JMS -®| PRINT 

H .ASCII “*1 /ERROR IN LINE/< 15> 


4.3.2 Created Symbols 

Often, it is desirable to attach a symbolic tag to a line of code within a macro definition. As this tag is de¬ 
fined each time the macro is called, a different symbol must be supplied at each call to avoid multiply defined 
tags. 

This symbol can be explicitly supplied by the user or the user can implicitly request MACRO-15 to replace the 
dummy argument with a created symbol which will be unique for each call of the macro. For example, 

H .DEFIN H MAC,A, ?B 

The question mark ( ?) prefixed to the dummy argument B indicates that it will be supplied from a created symbol 
if not explicitly supplied by the user when the macro is called for. 

The created symbols are of the form . .0000-. .9999. Like other symbols, they are entered into the symbol table 
as they are defined. 

Unsupplied real arguments corresponding to dummy arguments not preceded by a question mark are substituted in 
as empty strings; and supplied real arguments corresponding to dummy arguments preceded by a question mark 
suppress the generation of a corresponding created symbol. 


Example: 




(Definition) 

H 

.DEFIN 

H MAC, A,B, ?C, ?D , ?E 


H 

LAC 

H A 


H 

SZA 



H 

JMP 

H D 


H 

LAC 

H B 


H 

DAC 

H c # 


H 

DAC 

He 


D= 




H 

. ENDM 


(Call) 

H 

MAC 

H Y # ,,, ,MYTAG 

(Expansion) 

H 

LAC 

Hy # 


H 

SZA 
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H jmp H . .0000 
H lac H 

H DAC H ..0001 
H DAC H MYTAG 
.. 0000 =. 

If one of the elements in a real argument string is not supplied, that element must be replaced by a comma, as 
* in the call above. A real argument string may be terminated in several ways as shown below: 

Example: 

H MAC H A,B, i_j 
-) MAC H A,B ,,) 

H MAC H A,B,_, 

s" % 

H MAC H A,B ) 

H MAC H A,B,J 




4.3.3 Concatenation 


I 


If a dummy argument in a definition line of the macro body is delimited by the concatenation operator '@' and 
immediately preceded or followed by other characters or another dummy argument, the characters that correspond 
to the value of the dummy argument (real argument) are combined (juxtaposed) in the generated statement with the 
other characters or the real argument that corresponds to the other dummy argument. This process is called con- 
catenation„ 

The following example illustrates this operation, 

(Definition) 

(Body) 

(Call) 

(Expansion) 

(Call) 

(Expansion) 


.DEF1N —j MAC, TYPE, ADDR 

JM@TYPE H ADDR 

.ENDM 

CALL -J MAC, P,ROUT1 

JMP H ROUT! 

CALL -A MAC, S,<SUBR1 

,DSA H ARGMNT> 

JMS H SUBR1 

.DSA H ARGMNT 


The dummy argument TYPE is used to vary the mnemonic operation code of the generated statement. The charac¬ 
ter P, which is the corresponding value of TYPE in the first call to the macro, will be concatenated with the 
characters JM to form the mnemonic JMP, This action occurs because a dummy argument (i 8 e,, TYPE) is delimited 
by the concatenation operator (i.e„, is preceded by @) and is immediately preceded or followed by other 
characters or another dummy argument (i,e e , preceded by other characters JM). 


4-7 



Of course, in the case where other characters are to be concatenated with the value of a dummy argument, and 
the first of the other characters is a MACRO-15 delimiter, it is not necessary to delimit the dummy with the 
concatenation operator. The following example illustrates this rule. 

(Definition) H .DEFIN H MO VE, FROM, TO, LVL 

(Body) H .(FUND H SV.@LVL 

Hskp 

SV.@LVL H .BLOCK H 1 

H .ENDC 

Hdac h sv.@lvl 

HLAC -J FROM® LVL,X 

HDAC H TO @ LVL,X 

Hlac H SV.@LVL 

H .ENDM 

(Call) HmOVE UST,RUST,0 

(Expansion) JFUND SV.,0 

Hskp 

SV.0 H .BLOCK H 1 

H .ENDC 

Hdac -*| SV.0 

Hlac - ust 0 ,x 

Hdac H rustj3,x 

Hlac H sv .0 


In this example concatenation is used to test the existence of a named temporary location, and output code to 
define it if necessary 8 Then the concatenation operator - MACRO-15 delimiter rule is presented by concatenat¬ 
ing two dummy arguments and other characters beginning with a MACRO-15 delimiter,, In detail, one such 
concatenation string is a MACRO-15 delimiter (i e e e/ H )/ a dummy argument (i.e„, FROM), the concatenation 
operator (i.e., (<£), a second dummy argument (i.e., LVL), finally followed by other characters beginning with 
a MACRO-1 5 delimiter (i .e ., ,X). 

The reader may realize that the general case of real argument for dummy argument substitution performed by 
MACRO-15 is the application of the "other characters beginning with a MACRO-15 delimiter" rule presented 
above. In other words, argument substitution may be thought of as concatenation when the dummy argument is 
bounded by MACRO-15 delimiters, rather than a concatenation operator. 

Note that one ambiguous case can arise in use of the concatenation operator when the other character string to 
be concatenated with an argument value is the same as a dummy argument name. The following example illus¬ 
trates this problem. 

(Definition) H.DEFIN H WAIT, LUN,EV, ?TMP 

(Body) H.DEC 

Hjfund H w TCP@LUN 

Hjmp H .+3 

WTCPS LUN Hi 6 
TMP =EV+0 
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EV@LUN 

.ENDC 

.IFPNZ 

|EV 

,.ENDC 

,ENDC 

1CAL 

ENDM 


H TMP 


-| WTCP@LUN 


This macro was written with the intention of satisfying the following flow diagram, 


MACRO 

WAIT 


LUN,EV 



1 




OUTPUT THE ADDRESS 
OF LABEL "EVlun" 


OUTPUT THE VALUE 
OF EV HE SPECIFIED 














For instance, if the following call to the WAIT macro were coded (with WTCP10 undefined); 


(Call) 


WAIT 

H 10 


(Expansion) 


.DEC 

HWTCP10 

0) 



.IFUND 

(2) 


H 

JMP 

H .+3 

(3) 

WTCP1 0 

H 

16 


(4) 

TMP=+0 



Htmp 

(5) 


H 

.IFZER 

(6) 


H 

ljZf 


(7) 


H 

.ENDC 


(8) 


H 

.IFPNZ 

H TMP 

(9) 


“*l 

.ENDC 


00) 



.ENDC 


(ID 



CAL 

WTCP1 )0 

(12) 


Note that according to box 6 of the preceding flow chart, under these conditions it was desired to output: 


^EV10 

for line 7 of the above expansion rather than what was actually generated. This discrepancy occurs because the 
characters EV on the appropriate line of the body of the definition are not recognized as "other characters"® EV 
is also a dummy argument which is bounded by a MACRO-15 delimiter (i.e.,-^|on the Ieft)and the concatenation 
operator (i ,e., @ on the right). This will cause the concatenation of the value of dummy argument EV (i .e 
null) and the value of the dummy argument LUN (i.e., 10), thus producing the output shown on line 7 of the 
expansion. 

Following is a comprehensive example of the use of the concatenation operation in defining user macros: the 
definition of two macros, ERRMSG and MESSAGE. The purpose of ERRMSG is to cause a subroutine to be 
called (named ER.PRO) which will print an error message. 

it has as arguments the error number (from 0 to 77^) and an optional return address® The label of the error message 
to be output is created by concatenating ' ERM»‘ with the error number. (ERM.0, ERM.l , etc.) If no return 
address is specified, control is transferred to a label named ER.NOR by default. The second macro, MESSAGE, 
is used to create an IOPS ASCII line buffer with the error message to be printed, presumably via the ERRMSG 
macro. It also has two arguments: the error number, and the message text. The output of the macro is a 
properly set up header word pair labeled 1 ERM®xx' where 'xx‘ is the specified error number, and a ®ASCII state¬ 
ment which contains the text specified, preceded by 1 ERR^xx—where l xx' once again is the error number® 

The reader should examine the example noting the use of conditional assembly parameters to accomplish macro¬ 
time error detection. 
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.TITLE CONCATENATION EXAMPLE for macro manual 

/ 

/MACRO 'fRSNSG' DEFINITION , ERROR message ouput macro. 

/ 

/ CALLING SEQUENCE: 

/ 

/ pRPMSC £PR NO I e RF TURN) 

/ 

/ /here; 

/ rRRNO s A>J OCTAL NUMBER FROM 0 TO 77 REPRESENTING 

/ THE ERROR CODE. 

/ RETURN * (OPTIONAL] THE LOCATION TO WHICH CONTROL 

/ SHOULD BE RETURNED FOLLOWING OUTPUT OE 

/ THE ERROR MESSAGE. IF NOT SPECIFIED, 

/ CONTROL WILL BE GIVEN to LOCATION 'ER.NOR' „ 

/ 

/ OUTPUT: 

> 

/ rUTPur OF ERRHSG CONSISTS OF A JMS TO THE ERROR PROCESSOR 

/ IER. PRO' , FOLLOWED PY A .OSA ERM.XX WHERE XX = ERRNO. 

/ PPM.XX IS ASSUMED TO HE A STANDARD TOPS ASCII LINE PUFFER 

/ /HIGH CONTAINS THE DESIRED MESSAGE. IT MAY BE DEFINED USING 

/ THE 'MESSAGE' MACRO (SEE BELOW]. 

/ 

/ ERROR detections 

/ 

/ THF ERROR NUMBER ('ERRNO ' ) IS CHECKED TO BE BETWEEN 

/ ■■ And 77, OTHERWISE AN ASSEMBLER ERROR LINE IS 

/ .-'I.'TPUT rather than THE CALL TO ' ER.PRO' , THE ILLEGAL 

/ ASSEMBER LINE will CAUSE an ' N» ERROR (AMONG OTHERS} TO BE 

/ GENERATED BY THE ASSEMBER, THUS INDICATING A 'NUMBER' 

/ ERROR. 

/ 

.DEE IN 
.IFNEG 
.IFPOZ 

7 Z R T M C * R T N + 0 

.IFZER 

ZZRTNCsFr.NOR 
.ENDC 
T M S 
.OSA 
jMP 
.EXOC 
. ENDC 
.IFMEG 
5 

.ENDC 
.IFPOZ 
S 

.ENDC 

.ENDM 

'MESSAGE' DEFINITION. BUILD AN ERROR MESSAGE LINE BUFFER. 
CALLING SEQUENCE: 
message E r FNQ»<TEXT> 

WHERE: 

ERRNO = the error NUMBER, FROM 0 TO 77 (OCTAL] 

<TEXT> = THF MESSAGE TEXT (ENCLOSED IN ANGLE 

0PACKET5, AS SHOWN) TO BE ASSOCIATED WITH THIS 
' FRP.no ' . 


/ M ACRO 
/ 

/ 

z 

/ 

z 

z 

/ 

/ 

/ 

/ 


ERRHSG.ERRNO,RTN 

ERRKJQ-I08 /VALIDATE ERROR CODE NUMBER 

ERRNO /TO BE 0 <* ERRNO <i 77 

/SETUP RETURN AODR. IF SPECIFIED 

ZZRTNC 

/IF NO return, set to STD. addr. 


ER.PRO /CALL the ERROR PROCESSOR 

EPM.i^ERRNO /POINT TO RIGHT MESSAGE 

ZZRTNC /EITHER RETURN TO STD. EXIT, 


OR WHERE 1 


ERRNO /PUT OUT ERROR IF NECESSARY 

♦♦ERROR CUDF IS < 0 OR > 77** 


ERRNO-188 

♦♦ERROR COOF IS < 8 OR > 77 ** 


SAID 
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/ 

/ 

/ 

/ 

/ 

/ 

7 

/ 

/ 

/ 

/ 

/ 

/ 

/ 

/ 


f* R M 


UTPijT; 


t STAK'DAR" IOPS ASCII LINE BUFFER IS CREATED WITH THE NAME 
•FTM.Xx' '•> H F R E XX = * fcRRNO' (SEE ABOVE). THE ACTUAL MESSAGE 
V.’ ILL HAVE The FORMAT 'EKR#XX-- TEXT ' , WHERE XX AND TEXT ARE AS 
A BV E. 0 F COURSE, THE LINE BUFFER HEADER PAIR WILL BE PROVIDED. 

EP't'OR 0E T ECT I 0M : 


' FRRfjOi W ILL «E CHECKED TO BE BETWEFN *5 AND 77. 

IF THE CHFCK SHOWS am ERROR, AN assembler ERROR 
I I^E wjll BE GENERATED RATHER THE ThE MESSAGE CODE, THE ERROR 
! r-F will CAUSE AT LEAST An * N * FLAG, INDICATING A i NUMBER 1 
fR'JDR. 


. OFF IN 
„IPNEG 
. IFPfiZ 


MESSAGE,FRRMOfTtXT,?A 

£RRNO-lWP 

ERR m 0 

A-c RM , i?FRRND/2* 1 000 + 2 


0 


.ASCII 

»ERR##£RRNO--TEXT 

» 


.fc hi DC 

.E^C 

t 5 R*T. 



S 

♦♦ERROR CODF IS < 

0 OR > 

77 

.£*rc 

.1FPnZ 

EPRV0-li5iA 



9 

„ F : n C 

.EJECT 

♦♦ERROR CODF IS < 

0 OR > 

77$^ 


fKRMSG 4 /OUTPUT FRROR MESSAGE #4, TAKE STANDARD EXIT 


+ r; 

.IFMEG 

4-100 


*g 

. IFP07 

4 



Z Z R T N C - * 0 



* h 

. IFZER 

77RTNC 


+ G 

2 / R T M C a E R . M D R 



*G 

. ENDC 



*& 

jmS 

ER.PRO 



. 0 3 A 

FRM. 4 


* {• 

j,n 

zzftnc 


*G 

.F-DC 



*G 

.F\ ; OC 



* f. 

. IF meg 

4 


* ft 

■9 

♦♦ERROR CODE 

IS < 

* G 

a 



* in 

I1FPUZ 

4- 100 


+ G 

c 

♦♦ERROR CODE 

IS < 

* G 

>'-cc 




E p R M s G 

45,RECOV 

/ 

* f; 

. IFNEG 

45-lZ.o 


* G 

. IFPOZ 

45 


* C- 

Z Z R T m r s R E c C V + P 



♦ G 

IF 7 E P 

z 7 ftnc 


* G 

ZZRTnC sFr.nor 



*f4 

.E-'OC 



* c- 


E . P K 1 


* G 

0 $ A 

E P m , 4 5 


+ G 

JH.F 

ZZPTnC 


* G 

.FNOC 



* r; 

.EMPC 




0 OR > 77** 

15 DR > 77** 

IVE ERROR #45, ANU RETURN TO LOG 'RECOV' 




WHFN DONE 
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+ G 
*G 
*G 

* G s « $ 1* ft 6 s 8 

#G Q ENOC 

*G .FNOC 

*G .IFNEG 4 

* G @ * * E R R 0 R CODE IS < 0 OR > 77** 

*G a EMOC 

♦G /IFPOZ 4*100 

*C, g * TERROR CODE IS < 0 OR > 77** 

*G .ENOC 

MESSAGE 4 5 j> < A -M BIG U '0 U S USE OF A COMPILER KEYWORD^ 

*G /IFNEG 45-100 

*G .IFPOZ 45 

*G E&M.45 . .0009-ER.M.45/2*1000 + 2 

* G $ 

*G a ASCII iERR#45 —AMBIGUOUS use of a compiler keyword *«15» 

* G 
*G 

* U 
+ G 
*G 
*G 
*G 
*G 

* G 

* G 
+ G 

* 6 

+ G 

*G . lEN'EG 45 

*G g * * E R R 0 R CODE IS < 0 OR > 77** 

*G a ENiDC 

*G .IFPOZ 45-100 

*G 9 * + ERR0R CODE IS € 0 OR > 77** 

*G .ENOC 

FRPMSG -34.REC0V /SHOW THAT A NEGATIVE ERROR NO. IT ILLEGAL 

*G .IFNEG -34-130 

*G .IFPOZ -34 

*G ZZRTNC«RfCOV+0 


*G 

.IFZER 

ZZRTNC 

*C5 

Z4RTVC«ER.N0R 


* G 

.ENOC 


+ & 

JMS 

ER , PRO 

*6 

. DS A 

ERM.-34 

*G 

JHP 

ZZRTNC 

*G 

.ENOC 



*G .ENOC 

* G .IFNEG -34 

*G S **ERROR CODF IS < 0 OR » 77** 

*G .ENOC 

*r, .IFPOZ -34-100 

*G 9 **ERROR CODE IS < <3 OR > 77** 

* G .ENOC 

gkiRMSG 436 /SHOW THAT AN ERROR NO. > 77(85 IS ILLEGAL 

*G .IFNEG 456-100 

*G .IFPOZ 456 

*G ZZRTvre+o 

* G .IFZER ZZRTNC 

*G ZZRTMCwER.NOR 
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+ u . E n u C 


4 r. 

.T m -3 

ER *PRO 






* u 

JJSA 

EP'%456 






* Li 

T M P 

ZZRTNC 






*G 








4(i 

.Eonc 







* r; 

.iFnec, 

4 5 6 






*r; 

5 

**error 

CODF 

IS < 

0 

OR 

» 77 + * 

*G 

.F \QC 







*r; 

.IFPOZ 

456-1^0 






★ G 

9 

♦★ERROR 

CODE 

IS < 

0 

OR 

> 7 7 ★ ★ 


.E^nc 

.EJECT 


HESS ACE 4,<ILLEGAL hr UNRECOGNIZABLE SYNTAX IN 5TMNT> 

*p .IFNEK 4-100 

*C, .IFPOZ 4 

*F F R M . 4 . , iZ 0 SI 6 - E R M . 4/2* 1 0 '4 0 + ? 

* f; q 

*t .'ascii <ERR«4--ILLFGAL OR UNRECOGNIZABLE SYNTAX IN STMNT'<15> 

* f\ 

* r; 

* r; 

*u 

*G 

*G 

* G 
*G 

* G 

*-r 

*r, 

* G 

* G 


* h 

*n 


*G 


★ G 


*G 

. .»P»Ps ■ . 




★ G 

. E N D C 




★ r; 

.ENOC 




4 r; 

.JFMFG 

4 5 



4 g 

9 

♦♦ERROR CODE IS 

cr 

o 

E. 

V 

> 7 7 ★ ★ 

4 G 

4 c'vOC 




* G 

.IFPOZ 

45-10U3 



*f. 

Q 

♦♦ERROR CODE is 

< D OR 

> 7 7* ★ 

* G 

m E-’-DC 

message 

-1,<THI5 SHClJL0 

GIVE A 

MACRO-detected ERROR » 

*G 

„ IFVJFG 

-1-100 



*G 

. IFPOZ 

4 

* l 



4 G 

# .S012- 

ER M .-1/2*1-400 + 2 



4 G 

0 




* G 

.ASCII 

iERP&-1--THJS SHOULD GIVE A MACRO-DETECTED ENK0R'<15> 

# G 





4 G 

# fc-!OC 




* G 

. E N 0 c 





. tfneg 

-1 



*0 

9 

♦ ■★ERROR COOF IS 

« 0 OR 

> 77 ** 

’ G 

. r kj D.c 




*r, 

.IFPOZ 

-1-10 0 



♦G 

9 

★ ★ERROR CUOF IS 

< W OR 

> 7 7 ★ ★ 

* L 

# S’-*DC 





EJECT 
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4.4 NESTING OF MACROS 


Macros may be nested; that is, macros may be defined within other macros. For ease of discussion, levels may 
be assigned to these nested macros. The outermost macros (those defined directly) will be called first-level 
macros. Macros defined within first-level macros will be called second-level macros; macros defined within 
second-level macros will be called third-level macros, etc. Each nested macro requires an . ENDM pseudo op 
to denote its termination. 

Example: 


Level 1 


H .DEFIN H LEVEL1 ,A,B 

H lacH A 

H TADH B Level 2 


H .DEFIN H LEVEL2,C,D 

H iszH c 

H DAC~H D Level 3 



H .DEFIN H LEVEL3,E,F 

H andH e 

H xorH f 

H .ENDM f 

f 


LEVEL 3 .ENDM 

H dacH z 

H .ENDM J 

f 

LEVEL 2 .ENDM 

1 

dacH y 

.ENDM \ 

r LEVEL 1 .ENDM 


At the beginning of processing, first-level macros are defined and may be called in the normal manner. Second 
and higher level macros are not yet defined. When a first-level macro is called, all its second-level macros 
are defined. Thereafter, the level of definition is irrelevant and macros may be called in the normal manner. 

If the second-level macros contain third-level macros, the third-level macros are not defined until the second- 
level macros containing them have been called. 


Using the example above, the following would 

occur: 


Call 

Expansion 

Comments 

H LEVEL1 H TAG1, TAG2 

H LAC H TAG! 

H TAD H TAG2 

H dacH y 

Causes LEVEL 2 
to be defined 

H LEVEL2 -*) TAG3, TAG4 

H ISZ HTAG3 

H DAC H TAG4 

H DAC H z 

Causes LEVEL 3 
to be "defined 

H LEVEL3 H TAG5, TAG6 

H andH TAG5 

H XOR H TAG6 
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If LEVEL3 is called before LEVEL2 if would be an error, and the line would be flagged as undefined. 

When a macro of level n contains another macro of the level n + 1, calling the level n macro results in the 
generation of the body of the macro info the user’s program in the normal manner until the . DEFIN statement 
of the level n + 1 macro is encountered; the level n + 1 macro is then defined and does not appear in the user’s 
program. When the definition of the level n + I is completed (.ENDM encountered), the Assembler continues 
to generate the level n body into the user’s program until, or unless, the entire level n macro has been generated. 


4.5 REDEFINITION OF MACROS 

If a macro name, which has been previously defined, appears within another definition, the macro is redefined 
and the original definition is eliminated. For example. 


H .definH indxsv 

H JMS H SAVE 

H JMP H SAVXT 

SAVEH 0 

H LAC H 10 

H DAC H TMP # 

H LAC H 11 

H DAC H TMP1 # 

H JMP* H SAVE 
SAVXT=. 

—i .definHindxsv 
H JMS HSAVE 
H .ENDM 
H .ENDM 


When the macro INDXSV is called for the first time, the subroutine calling sequence is generated and followed 
immediately by the subroutine itself. After the subroutine is generated, a .DEFIN that contains the name 
INDXSV is encountered. This new macro is defined and takes the place of the original macro INDXSV. All 
subsequent calls to INDXSV cause only the calling sequence to be generated. The original definition of INDXSV 
will not be removed until after the expansion is complete. 

Call Expansion 

H INDXSV H JMS H SAVE 

H JMP H SAVXT 


4-16 



saveH 0 

H LAC H 10 
H DAC H TMP# 

H LAC H 11 
H DAC H TMP1# 

H jmp*H save 

SAVXT=. 

H INDXSV H JMS H SAVE 

4.6 MACRO CALLS WITHIN MACRO DEFINITIONS 

The body of a macro definition may contain calls for other macros which have not yet been defined. However , 
the embedded calls must be defined before a call is issued to the macro which contains the embedded call. 
Embedded calls are allowed only to three levels. 


Example: 

H .DEFIN H MAGI,A,B,C,D,E 
H LAC H A 

H TAD H B 

H MAC2 H C, D /EMBEDDED CALL 

H DAC HE 

H . ENDM 

H .DEFIN H MAC2,A,B /DEFINITION OF EMBEDDED CALL 

H XOR HA 

H AND H B 

H .ENDM 

The call 

H MAC1 HTAG1,TAG2, (400, (777, TAG3 
causes generation of 

-*| LAC H TAG1 

H TAD H TAG 2 

H MAC2 H (400, (777 

H XOR H ( 400 

H AND H (777 

H DAC HTAG3 
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4.7 RECURSIVE CALLS 


Although it is legal for a macro definition to contain an embedded call to itself, it must be avoided because 
the expansion will cause more than three levels to occur. 

Example: 


H .DEFIN -1 MAC,A,B,C 
H LAC —j A 

H TAD H B 

H DAC He 

H MAC H A,B,C /RECURSIVE CALL 

H . ENDM 

When a call for MAC is encountered by the Assembler, it searches memory for the definition and expands if. 
Since there is another call for MAC contained within the definition, the Assembler goes back once again to 
obtain the definition; this process would never cease if more than three levels were allowed. A conditional 
assembly statement could be used, however, to limit the number of levels as in the following example. 

Example: 


B = 3 

H .DEFIN H MAC,C,D 
H LAC H c 
~H DAC ~»| D 
A= A + 1 

H ,IFNZR -) B-A 

H MAC H SAVE, TEMP /RECURSIVE CALL 

H . ENDC 
H .ENDM 

Names and arguments of nested macros and arguments of imbedded calls may be substituted and used with perfect 
generality, 
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Example: 


H .DEFIN H MAC! ,A,B,C,D 
H LAC Ha 

H ADD HB 

H DAC Hc 

H .DEFIN H D,E 

H and Ha 

H dac He 

H . ENDM 
H .ENDM 

H .DEFIN H MAC2,M,N,0,P,Q, ?R 

isz Hm 

H JMP H R 

H MAC! HN,0,P,Q 
R=. 

H .ENDM 

The cal I 

H MAC2 -*| COUNT,TAG!,TAG2,TAG3,MAC3 

causes the generation of 

H ISZ H COUNT 

H JMP -«j ..0000 

H LAC H TAG! 

H ADD H TAG2 

H DAC -H TAG 3 

.. 0000 =. 

If also causes the definition of MACS 
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CHAPTER 5 
OPERATING PROCEDURES 


5.1 INTRODUCTION 

Detailed descriptions of the assembler calling procedure, command string format, general operating procedures, 
and printouts are given in this chapter (Refer to Appendix G for MACROI operating procedures and Appendix 
H for MACRO A.) 

5.2 CALLING PROCEDURE 

5.2.1 ADSS-1 5 and DOS-15 

In the ADSS-1 5 and DOS-15 systems, the MACRO-15 Assembler is called by typing MACRO^) after the Monitor's 
$ request. When the Assembler has been loaded, it identifies itself by typing: 

MACRO-15 VNN or BMACRO-15 VNN 
> > 

on the teleprinter. The > character indicates that the Assembler is waiting for the user to type in a command 
string. 

There are two differences between MACRO-15 (the Page Mode Assembler) and BMACRO-15 (the Bank Mode 
Assembler). MACRO-15 starts each assembly assuming page mode relocation (.DBREL implied) and BMACRO-15 
assumes bank mode relocation (.EBREL implied). When program sizes exceed 4096, MACRO-15 outputs the 

warning message PROG > -4K 11 in the assembly listing but BMACRO-1 5 does not 0 This message will appear even 

if the program is assembled under influence of .EBREL. This warning message has no other effect; the program 
will be assembled and output will be produced anyway. 

5.2.2 Background/Foreground (B/F) 

in B/F systems MACRO-15 is called in the same manner as for ADSS-1 5. It identifies itself by typing: 

BF MACRO-15 VNN 
for both the page and bank mode systems. 
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5,2.3 RSX PLUS and RSX PLUS III 


In the RSX systems, MACRO-] 5 is invoked by typing in the Assembler's name and also the command string on 
the same line following the prompting message "TDV>‘ ! . For example: 

TDV>MAC BLXR^FILF^ 

MACRO RSX VIA 

The Assembler identifies itself, as just shown, only if the R option is designated in the command. The RSX ver- 
sion of the Assembler is equivalent to BMACRO-15 in that it assumes .EBREL to begin with and does not print 
"PROG>4K" 8 

5.3 GENERAL COMMAND CHARACTERS 


The following characters are frequently used in the entry and control of MACRO programs. 
Character Printout 


RUBOUT (Echoes\) 
CTRL U (Echoes @) 
CTRL P (Echoesf P) 


CTRL D (Echoes ?D) 


delete single character 
delete current line 

a. If the input source is physically segmented so that all but the last segment end 
with .EOT or nothing, the Assembler will print out the message 

EOT 

when the end of a segment is reached. In RSX PLUS, the Assembler does not type 
any such message. 

b. If the source is segmented in such a way that operator intervention is required to 
load another segment. Macro will print 

4 P 

(MAC-4P in RSX PLUS) and wait for the user to key in CTRL P (CTRL P J in RSX 
PLUS). Except in RSX PLUS, the user response will be printed also and the line 
will appear as 

T P4P 

In RSX PLUS if one does not wish to load another tape, one may terminate assembly 
by typing CTRL Q J, 

c. At the start of PASS 2 or PASS 3 if input is on paper tape or if the source is seg¬ 
mented on DECtape or Magtape with segments being read via the same .DAT slot, 
the Assembler will request a CTRL P response as above, 

d. If the Assembler is not waiting for more input, or is not waiting to start the next 
pass, typing CTRL P causes the Assembler to restart at PASS 1 a This is true for all 
systems except RSX PLUS. 

If the user specifies the Teleprinter as the input parameter device, he can delimit 
the parameter code by typing CTRL D (4 D) (followed by J with the RSX Monitor), 
MACRO responds with EOT, MACRO immediately begins assembling the program 
from the device assigned to .DAT-11 (LUN 15 with RSX). 
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5,4 COMMAND STRING 


The command string format consists of a string of options, followed by a left arrow, followed by the program 
name(s), followed by a terminator. 

options filnml ,filnm2, .., 

The following sections describe the rules for forming proper command strings and show typical assembly examples. 
The character terminating the command line has significance. Terminating the line with a carriage return will 
cause the Assembler to re-initialize itself to PASS 1 at completion of the assembly; the Assembler is thus ready 
to accept another command string. Terminating the command with an ALT MODE will cause a return to the moni¬ 
tor at the end of assembly. In the RSX PLUS and RSX PLUS III systems these line terminators have a different 
meaning. Termination with carriage return causes TDV to be called; termination with ALT MODE does not. In 
either RSX case the Assembler exits after executing the command line. If a command string error occurs, the 
entire command must be retyped. 

5.4,1 Program File Name 

To the right of the back arrow in the command string, one or more program file names may be required, depending 
upon the options used and the type of I/O devices. Where several names are needed, they are separated by 
commas. 

Program names are required for files which are to be input from or output to directoried devices. The two proper 
forms for a file name are 

filnama_§exf 

or 

fi In am 

where 

filnam - 1 to 6 character name 
ext = 1 to 3 character extension 

These may be formed from any of the legal printing characters shown in Appendix A and may appear in any order. 

If the file name extension is omitted, the Assembler assumes SRC in default. Following are examples of single 
name command strings. 


5-3 



Examples: 


User Command String 

Assembler 

Name 

Interpretation 

Extension 

+- i_jABCDEFi_j100^ 

ABCDEF 

100 

AB uj01 1^ 

AB 

011 

*■ A J 

A 

SRC 

ABCDEF GJ 

ABCDEF 

G 

+• ABCDEFG «_jhU 

ABCDEF 

H 

- ( -abc 1 _ i 1 _ 1 viaJ 

ABC 

SRC 


The last three examples illustrate how the Assembler interprets improperly formed file names a If the file name is 
longer than six characters but is not followed by a space, the seventh, eigth and nineth characters are used as 
the extension. If it is followed by a space, characters beyond the sixth and before the space are ignored, (f 
two spaces follow the file name, the extension is assumed to be SRC. In general, if too many characters are 
given the excess characters are ignored. 

in DOS-15, RSX PLUS and RSX PLUS III systems the extension name of the main program is output (unless the O 
option is present) as a special code in the relocatable binary file. This enables programmers to easily identify 
different versions of the same program by merely assigning unique extension names. Since this special code is 
not legal in ADSS-15 and Background/Foreground, one may suppress it, when assembling in DOS or RSX, by 
specifying the O option® 

Regardless of the source file extension, such as TEST 001 , the binary file extension will be either BIN, meaning 
relocatable binary, or ABS, meaning absolute binary, 

5.4.2 Options 

Assembler options direct the course of the assembly. They describe the types of input and output desired. Option 
characters are listed to the left of the back arrow. They may be listed in any order and are typically not separated 
one from the other (although commas and spaces, which are ignored, may be used as separators). Option 
characters which appear more than once and invalid characters are ignored. 

Examples: 

Command Meaning 

B«-FILE^ Assemble FILE SRC and produce a binary 

object fi le. 

BLS^NAME^ Assemble NAME SRC and produce a binary 

object file and an assembly listing followed 
by a symbol table listing. 
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Examples (Cont„): 


Command Meaning 

+■ PROG&J01 xJ Assemble PROG 01X producing no 

output except a list of assembly er¬ 
rors, if any, on the listing device 
assigned to .DAT -12 (LUN 16 in RSX). 


The following table shows the action and the default of the options. 



Option Action 

A Print symbols at end of PASS 2 in 

alphanumeric sequence on listing 
device. 

B Generate a binary file to DAT*-] 3 

with extension BIN or ABS, as re¬ 
quired. (LUN 17 in RSX), 

C Program areas that fall between un¬ 

satisfied conditionals are not printed. 

It is not necessary to type the L op¬ 
tion if this option is used. 

D Suppress binary output and output the 

assembly listing onto DECtape Unit 2 
with a file extension of LST (used only 
by MACRO!). 

E This option enables the user to have 

any errors occurring during assembly 
printed on the console printer in ad¬ 
dition to the device assigned to .DAT 
-12 (LUN 16 in RSX). The L or N 
switch should be used with the E op¬ 
tion. This option is particularly useful 
to users who assign non-printing devices 
to .DAT-12. Not available with 
ADSS-15 or B/F. 

F Read macro definition file from .DAT 

-14 (LUN 18 in RSX) during PASS 1 . 
Terminate input with .EOT or CTRL D 
if Teletype (CTRL o) if RSX). Not 
available with MACROA-15. 

G Print only the source line of a macro 

expansion. It is not necessary to type 
the L option. 

H The H-option is used in conjunction 

with the A, V, or S options. User 
symbols are normally printed horizon¬ 
tally at the end of PASS 2, four sym¬ 
bols to a line. If the H-option is used 
the symbols will be printed one to a 
line. 

I Ignore .EJECT'S. The .EJECT pseudo¬ 

op is treated as a comment. Not avail¬ 
able with MACROI-1 5 nor MACROA-15. 


Default Action 

Symbols are not printed in alphanumeric 
sequence. 

A binary file is not generated. 

All source lines are printed. 

A binary, if desired, may be output to DEC¬ 
tape 2. The listing is output to the tele¬ 
printer o 

Assembly errors are not printed on the con¬ 
sole printer. 


No macro definition file is processed. 

Generate printouts for macro expansions and 
expandable pseudo-ops (e.g., .REPT). 

Print symbols four to a line. 


Skip to head of form when .EJECT is encountered. 
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Default Action 


Option 

L 


N 

O 


P 


R 


b 


T 


U 

V 

X 


Action 

Generate a listing file on the re¬ 
quested output device, DAT-12,, 

(LUN 16 in RSX). If the output 
device is directoried, then the 
listing file extension will be LST. 
Number each source line (decimal),, 

If this option is used, it is not neces¬ 
sary to type the L option. 

Causes the assembler to omit the 
source extension and the linking 
loader code 33 from the binary file. 

This option must be used when assem¬ 
bling programs in the DOS or RSX 
PLUS systems to be run in ADSS or 
B/F. 

Before assembly begins, read program 
parameters from DAT-10 (LUN 20 
in RSX) e Terminate input with ®EOT 
or CTRL D (if Teletype)® The parameter 
file is read only once; for this reason, 
only direct assignments may be used* 

identify the Assembler version number, 
print END PASS 1 and END PASS 2, 
and print the error count on the tele¬ 
printer (RSX PLUS and RSX PLUS III 
only). 

Same as selecting both A and V. 

The T option causes a "Table of Con¬ 
tents" table to be generated during 
PASS 1 „ The table will contain the 
page number and text of all assembled 
.TITLE statements in the program. Not 
available with ADSS-15 or B/F. 

The assembled binary is output to 
DECtape Unit 1 (Used only by 
MACRO I). 

Print symbols at end of PASS 2 in value 
sequence on listing device. 

At completion of PASS 2, PASS3 is 
loaded to perform the cross-referencing 
operation. At completion of PASS 3 the 
Assembler will call in PASS 1 and 2, to 
continue assembling programs. If the 
command string was terminated by an 
ALT MODE, control will return to the 
Monitor at the end of assembly. If the 
L and X options are entered, the user 
should also enter the N option with the 
ADSS or B/F Systems. Without the N 
option the user would obtain a cross 
reference which would be effectively 
useless since the source lines of the 
listing are not numbered. In the DOS 
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A listing file is not generated (see options 

N, C). 


Source lines are not numbered. 

Loader code 33 is included in the binary 

output. 


No parameters, begin assembly immediately 
after command string termination. 


These items are not printed in order to speed 
up batch processing. 


Symbols are not printed, (If neither option 
V, S nor A is requested, symbols are not 
printed.) 

A table of contents is not generated at the 
head of the assembly listing. 


The assembled binary may be output to 
DECtape Unit 2 if the B option is selected* 

Symbols are not printed in value sequence. 

A cross-reference is not provided and PASS 3 
not cal led in . 



Default Action 


Option Action 

and RSX PLUS systems the N option is 
automatically entered if you enter L and 

X 0 Not available in MACRO I-15. 

Z The Z option is related to the macro The F option, if specified, causes the Macro 

definition file option F. Z has no definition file to be read only during PASS 1 . 

effect if F is not also specified. FZ 
are used in combination when the main 
program is segmented into two parts. 

The first part, containing instructions 
other than simply macro definitions, 
must be read both during PASS ] and 
PASS 2, This is the function of the Z 
option* (Not available with 

MAC ROM 5 or MACROA-15). 

5*4.3 Multiple Filename Commands 

In the general case a command may require up to three file names, depending upon the options specified, to 
produce a single binary output file. As will be illustrated later on, the Assembler in RSX PLUS and RSX PLUS 111 
systems allows multiple assemblies to be specified in a single command, which may require more than three file 
names. For the other software systems, the limit is three. Names may be needed to specify parameter files, 
macro definition files and program files. The use of these names and the manner in which they are interpreted by 
the MACRO Assembler are described in the following paragraphs. 

NOTE 

In the following descriptions any file which is processed 
by both PASS ] and PASS 2 of the Assembler is also proc¬ 
essed during PASS 3 if the cross-reference option (X) is 
specified. 

NAME 1: PARAMETER FILE 

If the P option Is used and the device assigned to .DAT slot -10 (LUN 20 in RSX) has a directory, the 
first name is interpreted as being the parameter file name* The name of the file must be explicitly stated 
if it is on a directorled device* If the device assigned to the parameter file is non- 
directoried, the first name typed would follow the rules for name 2* The parameter file is passed over 
only once during PASS 1 * 


If the P option is not used, only two names are accepted by the command string processor. The first name 
then would follow the rules for name 2 S 


NAME 2: MACRO DEFINITION FILE 

If the F option is used, the second name (or the first if the P option is not used) is interpreted as being 
the macro definition file or part one of a two part program (assuming the device assigned to .DAT-14 
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(LUN 18 in RSX) has a directory). If the device is non-directoried, the second file name (or first if the 
P-option is not used or doesn’t require one) would follow the rules for name 3„ The macro definition is 
normally passed over only once, during PASS 1 . However, unlike the main program file, macro defini¬ 
tions on e DAT slot -14 are recorded in core during PASS 1 . Hence, PASS 2 is unnecessary. If the Z 
option is used with the F option this file will be passed over twice, allowing source files in two parts on 
two different devices. The Z-switch has no effect if F is not specified. 

If the F option is not used, the first name (second if P option is used) is interpreted as the file name of 
the program to be assembled. 

The macro definition file may also be used as an additional parameter file, A second parameter file is 
useful where a program is conditionally assembled to produce different versions according to many 
assembly parameters, 

NOTE 

The RSX MACRO does not contain definitions of system direc¬ 
tives and I/O calls. MACRO definitions for RSX are in a file 
called RMCoV SRC, where V changes with each release, 

NAME 3: PROGRAM FILE NAME 

The name of the program to be assembled. This file is processed from .DAT slot -11 (LUN 15 in RSX) and 
always by both PASS 1 and PASS 2. If the P and F options are not used and multiple names are typed, 
only the first name will be processed. If a binary output file is requested, it will be directed to ,DAT 
slot -13 (LUN 17 in RSX)* If either of the two devices has a directory, a file name must be specified, 

The binary file will assume the name of the program file and an extension of either BIN or ABS, 


MULTIPLE NAME INTERPRETATION 

Before processing, MACRO uses the ,FSTAT function (SEEK in RSX) to determine whether or not the 
named files are on the input devices. If not, the message 'NAME ERROR' is typed. In all but the RSX 
and BOSS-15 systems the Assembler then expects the command string to be retyped. In RSX, the Assembler 
exits and calls TDV so that the command string can be given to TDV. In BOSS-15 the Assembler exits to 
the monitor. Assuming that enough names have been typed to satisfy the command string options, 

MACRO interprets the file names as follows: 

a. Current name = NAME 1 . 

b. Was the P option used? If not, go to step f. 

c. Is the device assigned to -DAT slot - 10 (LUN 20 in RSX) directoried? 

If not, go to step F , 
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d. Use the current name (NAME 1) to .SEEK the parameter file via e DAT slot -10 (LUN 20 in RSX). 

e. Current name = NAME 2. 

f. Was the F option used? If not, go to step j. 

g e Is the device assigned to .DAT slot -14 (LUN 18 in RSX) directoried? If not, go to step j, 

h. Use the current name (NAME 1 or NAME 2) to .SEEK the MACRO definition file via .DAT slot -14 
(LUN 18 in RSX). 

i . Current name = NAME 3 (or NAME 2 if P option not used). 

j. Use the current name (NAME 1 or NAME 2 or NAME 3) to .SEEK the program file via .DAT slot -11 
(LUN 15 in RSX). 

RULES FOR MULTIPLE NAMES IN THE COMMAND STRING 
1 . initial blanks positioned after the back arrow are ignored. 

2. Files are processed sequentially. The first name after the left arrow is the first file read, the second 
file is next and so on. 

3. Once a string of legal name characters is started, a space has the following effect on a name. 

A e The first space delimits the proper name and indicates to the command string processor that the 
extension name is next. The proper name is defined as the first six characters of a file name, 
excluding the extension. 

B. Two consecutive blanks delimit the name. An extension of 'SRC 1 is implied if no extension was 
typed. 

4. A comma or line terminator delimits the name. (Same as 3B above.) 

5. Any name given after the third name is ignored, except in RSX PLUS and RSX PLUS III. The RSX 
assembler allows multiple assemblies to be specified in a single command. Where the options require 
one, two or three file names, the command may contain multiples of one, two or three. Each such 
group of one, two or three names represents a single assembly. 


RESTRICTIONS CAUSED BY MULTIPLE FILE INPUT (not relevant to RSX PLUS or RSX PLUS III) 

The .FSTAT system macro is used by the MACRO Assembler to determine whether or not the input device 
has a directory and whether or not the argument names are on the assigned devices. For this reason, only 
those I/O handlers which honor or which ignore the .FSTAT function may be used with MACRO « The "A" 
handlers for directoried devices (e.g., DTA, DKA) honor .FSTAT, The paper tape punch and reader 
handlers ignore „FSTAT, but the effect is as if they accept it. Device handlers which treat .FSTAT as 
illegal may not be used. 


5,4.4 


Examples of Commands for Segmented Programs 


Below are typical assembly situations which illustrate the usage of some of the assembly options and show the 
resulting teleprinter output. The output for RSX PLUS differs slightly from what is shown. That is explained in 
section 5.3. 
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1 . Segmented Program on Paper Tape 

A source main program is segmented onto three paper tapes to make loading in the reader easier. 
Tapes one and two terminate with an .EOT statement and tape three terminates with .END. All 
three segments are read from, the primary input, *DAT-11 (LUN 15 in RSX). The command to Macro 
to produce a binary program is: 

>B■«- ANYNAM ) 

Note that tape 1 must be ready in the reader before the command string is entered. Were it not, the 
reader would return an end of tape condition anyway and erroneous results would be obtained. The 
resulting teleprinter output is shown below. The comments to the right are not part of the output; 
these are included here as explanatory remarks. User responses are underlined, 

> B ANYNAMJ 

EOT 

TP T P 
EOT 
TP f P 

END OF PASS 1 
TP T_P 
EOT 
TPTJP 
EOT 
T P T_P 

SIZEN2fl2j2f3 NO ERROR LINES 

2. Segmented Program on DECtape 

A source main program cannot fit onto a single DECtape. It is split in two on two different DEC- 
tapes and given the same file name: MAIN SRC. The tape one file ends with »EOT; the tape two 
file ends with e END a The file names must be identical if both segments are to be read via the 
primary input, .DAT *-11 (LUN 15 in RSX), Example 3 Illustrates an alternate method. However, 
example 2 must be used if one also is to include a Macro definition file, as in example 4. The 
following command to Macro produces a binary program and the subsequent teleprinter output: 

> B_r MAIN J 

EOT 
TPT P 

END OF PASS 1 
T P T P 
EOT 
TP TP 

SIZE=J0JZf7J2f3 NO ERROR LINES 

3, Segmented Program on Disk 

This example is a variation of number 2. A two part main program resides on disk. It doesn't matter 
whether the two files are on the same or separate disk units. Part one terminates with .EOT; part 
2, with .END, PARTI SRC will be read via the secondary input, 0 DAT -14 (LUN 18 in RSX); and 
PART2 SRC will be read via the primary input, .DAT -11 (LUN 15 in RSX). The resultant binary 
file, produced by the following command to MACRO, will assume the name of the second (primary) 
file: PART2 BIN or PART2 ABS, as the case may be: 

/End of PARTI SRC. 

/End of PART2 SRC. 

/End of PARTI SRC, 


> BFZ PARTI, PART2 J 
EOT 

END OF PASS 1 
EOT 

SIZE“02003 NO ERROR LINES 


/End of file 1 . Mount second 
^DECtape on same unit. Type CTRL P. 
/End of file 2. Mount first 
/DECtape on same unit. Type CTRL P. 
/End of file 1 . Mount second 
/DECtape on same unit. Type CTRL P. 


/End of tape 1 „ 

/Ready tape 2. Type CTRL P. 
/End of tape 2, 

/Ready tape 3. Type CTRL P. 

/Ready tape 1 . Type CTRL P, 
/End of tape 1 . 

/Ready tape 2, Type CTRL P. 
/End of tape 2. 

/Ready tape 3. Type CTRL P, 
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Several points can be made about the differences between examples 2 and 3* First, note that 
CTRL P type In is not required unless Input is from a device like paper tape* Next, note that 
example 2 Is Impractical on disk because It requires physically interchanging disks* Example 3 
is not restricted to usage with disk, but can be used with other media as welL 

Use of a Macro Definition File 


MACDEF SRC, which terminates with »EOT, contains only Macro definitions* It is read from the 
secondary input, *DAT -1 4 (LUN 18 in RSX)* The user has a main program, USEMAC 002, which 
terminates with *END and which calls some of these macros but does not itself define them* This is 
just an example* It is perfectly legal for the main program to redefine macros which also appear in 
the macro definition file* USEMAC 002 is read from the primary input, . DAT “11 (LUN 15 in RSX)* 
Below is the appropriate command string to produce a binary program* Note that the F option with¬ 
out the Z option (see example 3) instructs the Assembler to read the first file (the Macro definition 
file) only during PASS 1 * 

> BF-*- MACDEF,USEMAC 0022 . 

EOT 

END OF PASS 1 

SIZE-01104 NO ERROR LINES 

Note that EOT is not printed during PASS 2 because MACDEF SRC is read only during PASS 1 . The 
preceding example assumes that the files are on directoried devices* 

Parameter File on Paper Tape 

A main program, MAIN SRC, which terminates with *END Is conditional ized to produce different 
binary code based on the values or existence of certain assembly parameters* It is read via the 
primary input, *DAT -11 (LUN 15 in RSX), which, for this example, is assigned to DECtape* 

A paper tape containing parameter definitions (direct assignments) terminates with *EOT and is 
read via the auxiliary input, * DAT -10 (LUN 20 in RSX)* The following command to Macro pro¬ 
duces a binary program; 

> BP + MAIN^ 

EOT 

END OF PASS 1 

SI ZE=00602 NO ERROR LIN ES 

Note, although input is partly from paper tape, a CTRL P response is unnecessary because the param¬ 
eter tape is read only during PASS 1 . 

Multiple File Assemblies in RSX 


/End of parameter tape. 
7 End of MAIN SRC. 


/End of MACDEF SRC. 
/End of USEMAC 002. 


Using the Assembler in RSX PLUS or RSX PLUS III, several assemblies, using the same set of options 
for each, may be specified in a single command. Unless the R option is used, no printout on the 
teleprinter will occur to signal the various stages of assembly. Below are listed two typical commands 
in RSX. 

>MAC BL-*- PI,P2 t _ J 003, P3,P 4j 

This requests four assemblies. A separate binary and listing are produced for PI SRC, P2 003, P3 SRC 
and P4 SRC. 

>MAC PB«- PARI ,FIL1 ,PAR2,FIL2j 

This requests two assemblies. A separate binary is produced for Fill SRC and FIL2 SRC. The param¬ 
eter file PARI SRC is applied to the assembly of FIL1 SRC and PAR2 SRC to that of FIL2 SRC. 





5*5 ASSEMBLY LISTINGS 


If the user requests a listing via the command string, the Assembler will produce an output listing on 
the requested output device. The top of the first page of the listing will contain the name of the program 
as given in the command string. The body of the listing will be formatted as follows: 


Line 

Number 

Error 

Flags 

Location 

Address 

Mode 

Object 

Code 

Address 

Type 

Line 

Type 

Source 

Statement 

xxxx 

XXX 

XXXXX 

[R] 

XXXXXX 

[R] 

*G 

X 

X 






[A] 

*L 








[E] 

*R 









*E 




where; 

Line Number = Each source line and comment line is numbered (decimal); generated 

lines are not included. Lines are not numbered unless the X or N 
option is specified. 

Flags = Errors encountered by the assembler 

Location = Relative or absolute location assigned to the object code. 


Address Mode = Indicates the type of user address, 

A = absolute 
R = relocatable 


Line Type = *G = Generated *L=Literal *R=Repeated *E=Extern.al 

Object Code = The contents of the location (in octal) 

Address Type = Indicates the classification of the object code, 

A = absolute 
R = relocatable 
E = external 

The object codes assigned for literals and external symbols are listed following the program. 


5,6 SYMBOL TABLE OUTPUT 


At the end of PASS 2, the symbol table may be output to the listing 6 DAT -12 (LUN 16 in RSX) device. If 
the A option is used, the table will be printed in alphanumeric sequence; if the V option is used, the symbol 
table will be printed in numeric value sequence; if the S option is used, the symbol table will be output in 
both alphanumeric and numeric sequence. The format is as follows: 

Symbol Value Type 


SYMBL1 XXXXX E 

SYMBL2 XXXXX R 

DIRECT XXXXXX A 
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The Xs represent the octal value assigned to the symbol. This is the location where the symbol is defined, ex¬ 
cept for external symbols. For these, the value is the location of the transfer vector, whose contents are set at 
program load time with the actual value of the symbol* Note that for SYMBL1 and SYMBL2 there are five Xs 
but that there are six Xs for the symbol DIRECT* Symbols having six octal numbers to represent their values are 
the result of direct assignments* 

The symbol table shows the type of symbol: 

A - absolute 
R = relocatable 
E = external 

Locations assigned to variables immediately follow the last object code producing statement in the assembled 
program. Locations assigned for literals not under «LTORG influence and transfer vectors are listed immediately 
following the variables; if no variables are used in the program, literals and transfer vectors immediately follow 
the program output* 



PAGE 

1 

2 

3 

4 

5 

6 
7 

g 

9 

10 

11 

12 

13 

14 

I 5 
16 
17 

II 


45 

46 


SAMPLE SRC SAMPLE PROGRAM 

a TITLE SAMPLE PROGRAM 

/ SAMPLE SUBROUTINE, not CLAIMED to WORK OR to HAVE ANY PRACTl 
/ VALUE, USED TO ILLUSTRATE THE OUTPUT ON AN ASSEMBLY LISTING, 
THESE LINES are COMMENTS. 


CAL 


^20005 a 


/ 

/ 

/ 

/ 

/ 

OUT ^ 5 


THIS LISTING WAS OBTAINED USING BMACRO-15 IN DOS-15 WITH THE 
FOLLOWING COMMAND OPTIONS TO MACROS LSX 

/.OAT SLOT 5. 

.IODEV OUT 

,GLOBL print,SAVE,restor 




WIDTHS?? 


.IFUNO WIDTH 
.DEC 

> OCT 
,ENOC 


19 




000040 

A 


BUFSIZsWlDTH+4/5*a*2 

20 







/ 



at 



P 

000000 

A 


PRINT 

0 


92 



© 

040116 

R 



DAG 

ACSAV# 

23 



P 

909123 

R 



LAC 

CSAVBUF) 

24 


^0003 

P 

120122 

E 



JMS-fc 

SAVE 

25 


0 00 0 4 

© 

92011 6 

R 



LAC* 

ACSAV 

26 


0 0005 

P 

741200 

A 



SNA 


27 

u 

0 0 0 P 6 

© 

600 117 

R 



JNP 

nobuff 

28 

F 

0 0 0 0 7 

0 

040003 

A 



0 AC 

WRITERS 

29 


000! 0 

P 

723777 

A 



AAC 

-1 

30 


000 ! ! 

P 

060 124 

R' 



DAC* 

e 10D 

31 


0 0 0 I 9 

9 

777740 

A 



LAW 

®BUFSXZ 

32 


000 ! % 

P 

040 I 15 

R 



DAC 

COUNT 

33 


mm%& 

© 

736000 

A 



CLK 


34 


5 

P 

220010 

A 


LOOP 

LAC* 

10 

35 


0 00 16 

P 

050055 

R 



0 AC 

BUF § t 

36 


00017 

© 

440115 

R 



ISZ 

COUNT 

37 


0 00 20 

P 

600015 

R 



JHP 

LOOP 

30 


00021 

P 

600024 

R 



JM P 

CHANGE 

39 


00022 

P 

200125 

R 


NOBUF 

LAC 

CERRM3G) 

40 

U 

00023 

© 

040123 

R 



DAC 

WRITES 

41 


00024 

P 

74000® 

A 


CHANGE 

NOP 


42 








B I N I T 

OUT f t t 0 



00025 

© 

001005 

A 

*G 


CAL + IM000 OUTS? 



00096 

P 

000001 

A 

*G 


1 




00027 

© 

000000 

A 



04-0 




00030 

© 

000000 

A 



0 


43 


00031 

© 

900120 

R 



LAC 

(JMP ARO 

44 


00039 

© 

0 4 f?* 0 2 4 

R 



DAC 

CHANGE 


/CONDITIONAL ASSEMBLY. 

/DECIMAL NUMBER. 

/DIRECT ASSIGNMENT. 

/SUBROUTINE ENTRY POINT. 
/VARIABLE, 

/LITERAL. 

/EXTERNAL CALL. 

/BUFFER ADDRESS. 

/UNDEFINED SYMBOL (MISSPELLED) 
/UNDEFINED SYMBOL BECAUSE OF 
/? FORWARD REFFRENCfS. 
/AUTOINDEX REGISTER. 


/INDEX REGISTER HEFERENCF, 

/UNDEFINED (MISSPELLED). 
/SYSTEM MACRO CALL. 


.EJECT 


/PAGE EJECT, 
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PAGE 

2 

SAMPLE 

SRC 


sample program 



47 




00(^033 

R 


WRITEsAROUND 


/FORWARD REFERENCE. 

48 


00033 

p 




AROUND , WRITE 

OUT,2,XX,0 

/SYSTEM MACRO CALL. 



00033 

© 

0 0 $ 0 0 5 

A 

* G 


CAL+2*iB00 QUT8777 




00034 

g> 

000011 

A 



11 





0003®^ 

p 

740040 

A 

&G 


XX 









*G 


0 DEC 





00036 

p 

000000 

A 

&G 


-0 



49 







/ 




§0 








@ WAIT 

OUT 

/SYSTEM MACRO CALL. 



00037 

p 

000005 

A 



CAL 0UTS777 




0004$ 

p 

000012 

A 



12 



si 


000 41 

p 

$00123 

R 



LAC 

CSAV9UF) 


5? 


0004$ 

p 

120121 

E 



JMS* 

RESTOR 

/EXTERNAL CALL. 

S3 


00043 

p 

$00116 

R 



LAC 

ACSAV 


54 


00044 

p 

$20000 

R 



J MP* 

PRINT 


55 







/ 




56 







/ THE 

NEXT LINE 

CONTAINS THREE 

.STATEMENTS, 

57 







/ 




58 


00045 

p 

003002 

A 


ERRMSG 

0030021 

0? .ASCII /ERR0R/«15» 



0004$ 

p 

000000 

A 








00047 

p 

4?$452 

A 








00050 

p 

947644 

A 








00051 

p 

064000 

A 








0005? 

R 

00^000 

A 






59 


0005$ 

P 





.LOC 

o”l 

/CHANGE LOCATION CHUNTER, 

@0 


0005$ 

P 


A 


8AVBUF 

,BLOCK 

3 

/MQ* XR AND LR e 

Si 


00055 

P 


A 


8UF 

.BLOCK 

BUFSIZ 


62 


00115 

P 

00000® 

A 


COUNT 

0 



63 







/ 




84 







/ FOLLOWING The 

.END STATEMENT 

ARE THREE LOCATIONS (NOT SHOWN) 

65 







/ FOR 

ONE VARIABLE (ACSAV) AND 

TWO UNDEFINED SYMBOLS (N06UFR 

66 







7 AND 

NRITE, THE 

LATTER BECAUSE 

OF A DOUBLE FORWARD REFERENCE) 

67 







/ FOLLOWING THAT 

(SHOWN) ARE TWO EXTERNAL TRANSFER VECTORS 

68 







/ AND 

FOUR literals. 


69 







/ 




70 




000000 

A 



.end 





00121 

P 

000121 

E 








0012$ 

P 

000122 

E 








00123 

P 

000052 

R 

*L 







00124 

© 

00001 0 

A 

^L 







00125 

P 

000045 

R 

*L 







1 26 



R 








$ItE 

5100130 



3 ERROR LINES 
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Sa -APLt PROGRAM 


ACS h v 

4 1 1 S 


* t i f 0 


K 

C M A H G L 

> ** 2 4 


r : i * r 

s '-A \ X 5 

K 

K 0 A l F 

*2 o 


b n * F fc 

r*i 17 

k 

REST f*K 

I'M 1 d 1 

P 

5 ‘i V P i; F 

52 

K 

v* ! P I T 

-* * 1 ? 

n 

». r* T T c 

h-'h 33 

* 


■»U; * ' A ^ 

’*T 

•] 

J| * s 

& 

C H A r ■ £ E 

F % d 


A m n i ■ a 5 


K 

F k P 5 h 

■* i\ 6 F 

s? 

« - l V k U P 

• • ' * 5 ? 

n’ 

r o u ^ t 

Hi 1 1 * 


i, C 5 V 

Mi lo 

w 

RcSI r-K 

■? * 1 ? 1 

P 

^ , V' - 

' *12? 

b 


RuF 

f* c* n 5 $ 


KUF 5 IZ 

R F 0 0 4 0 

A 

gRSMSG 


« 

LOOP 

0 0 fe? 1 5 

F 

OUT 

0$ p< ^ *4 5 

A 

PRINT 

70000 

R 

save 

00122 

E 

fclDTH 

00011^ 

A 


LOOP 

00 0 15 

E? 

K-OoUF 


R 

w £ I T E 

0-oi 33 

R 

BUFSI7 

jl fic* p 4 ^ 

A 

HijF 

Qi ^055 

R 

w 1 UT H 

0POU I/* 

A 

nobuFf 

00117 

R 

MUT 


R 


a c: s a 

l H. 

»5 


«3 

w 


.< 

17 


’ U i F 

t* m r*i fS F 

? f 

'■ 1 + 


r r F S I 4 

*» K 4 ^ 

1 0 * 

* i 


On A *>, Gr 

»' 2 1 

-? Vr 

'■ ) * 

44 

ri]\Us i 

> •• 1 1 « 

s F 

4 c 

*;?* 

FRRrSU 

^ ^ n 4 S 


R 4 - 


L U> 

=/ 7 -7 1 F 

^ 4 

5 7 


• j n p 11 F 

. S » 2 ? 

7 * 



, t.pi,Fb 

^* 11 7 




? I / T 

.-£ flj j«, > « 

i 

i i 


PR Ip T 

Ml - ^ v ?* 

i; 

P 1 ^ 

5 4 

qp s i r.k 

v «1 21 

i ? 

K >2 


? A \/K! 'F 

v- A ^ 5 0 

? 3 


^ ■/. ☆ 

S A V b 

^ M 2 ? 

i ? 

^ 4 


«I01H 

r;< 0 ^ i i -i* 

1 4 

1 A * 

1M 

^ r i r 

ts 'M ? 4 

4 r 



r RITE 

71 «! <7 3 3 

^ A 

17 * 



5.7 RUNNING INSTRUCTIONS 


Once the Assembler has identified itself,, it is ready to perform an assembly. Proceed as follcws: 

a. Place the source program to be assembled on the appropriate input device, 

b. Type the command string. 


5 o 7 0 l Paper Tape Input Only 

The following steps are required when the source program is encountered in the paper tape reader: 

a. At the end of a source tape segment which is not terminated with a .END statement or at the 

beginning of PASS 2 or PASS 3, the Assembler types 

TP 

b. Place the proper source tape In the reader and, if the computer is a PDP-9, push the tape-feed 
button to clear the EOT flag. 

c. In all systems except RSX PLUS or RSX PLUS III type CTRL P to continue. For the latter, type 
CTRL ?) . 
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5.7,2 Cross-Reference Output 


At the end of PASS 2, PASS 3 will be performed by the Assembler for the cross-referencing operation if the X 
option is requested. At completion, the assembler will be restarted (except in RSX systems) to permit additional 
assemblies if the command string is terminated by a CARRIAGE RETURN (J) entry. 

When a cross reference output is requested, the symbols are listed in alphabetic sequence. The first address 
after the symbol is the location where the symbol is defined or its 6—digit value if it is a direct assignment. All 
subsequent locations represent the line number (decimal) where the symbol was referenced* The line number with 
the asterisk is that in which the symbol is defined. Leading zeros are suppressed for the cross-reference symbol 
table. Nine line numbers are printed on one line and subsequent line numbers are continued on the next line. 

Example: 


PAGE 

1 

PRGA 

CROSS REFERENCE 

A 

1 

xxxxx 

xxxxx 

xxxxx:.. ... .xxxxx 
xxxxx 

B 

5000 

xxxxx* 


SYMBOL 

100 

xxxxx* 



Cross referencing can be a useful tool even without the aid of a line printer. It is possible to put the 
source assembly listing with line numbers onto a direcforied device, such as, DEC tape, and the cross 
reference table (by a separate assembly) on a teleprinter. Then, desired lines in the 8, LST U file can be 
accessed by using the EDITOR, 

LIMITATIONS 

A, Before cross reference output can begin, PASS3 of the Assembler must first have read the entire 

source file(s) and stored the reference line numbers in core memory. Should available core be 
too limited, the Assembler will output the following message to the listing: 

CORE EXHAUSTED AT LINE DDDD 

where D is a decimal digit. Then the Assembler outputs all the references found up to that point. 

B. For programs with more than 9999 lines of source code, line numbers begin again at 0000 on line 
100000 In the cross-reference listing, 10000 is represented as :000 r 11000 as ;000, and so on. 
These special characters are simply those which follow the numerals in the ASCII character set 
(Appendix A), Below is a list of characters and their meanings, 

: 10 

; 11 

< 12 

= 13 

> 14 

? 15 
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C. To conserve core space, PASS3 of the Assembler does not maintain a permanent symbol table. 
Consequently, if user defined symbols are identical to permanent symbols, references to the 
permanent symbols will be included in the cross reference. For example: 

LAC A 
TAD LAC 


LAC 5 

Three references to LAC will be listed® 

D. Conditionals (JFxxx through .ENDC) are treated during PASS3 as if they are always satisfied. 
Consequently, although a conditional might not be satisfied during PASS1 and PASS2, references 
within to defined user symbols will appear in the cross-reference output. 

Note that undefined symbols which are referenced in . IFDEF and .IFUND statements remain unde- 
fined; hence, these do not appear in the cross reference. 

5.8 PROGRAM RELOCATION 

The normal output from the MACRO-15 Assembler is a relocatable object program, which may be loaded into 
any part of memory regardless of which locations are assigned at assembly time. To accomplish this, the address 
portion of some instructions must have a relocation constant added to it. This relocation constant is added at 
load time by the Linking Loader, CHAIN or TKB; it is equal to the difference between the memory location that 
an instruction is actually loaded into and the location that was assigned to it at assembly time. The Assembler 
determines which storage words are relocatable (marking them with an R in the listing), which are absolute 
(making these non-relocatable words with an A) and which are external (marking these with an E). The rules 
that the Assembler follows to determine whether a storage word is absolute or relocatable are as follcws. 

a. If the address is a number (not a symbol), the address is absolute. 

b. If the address is a symbol which is defined by a direct assignment statement (i ,e., -) and the right- 
hand side of the assignment is a number, all references to the symbol will be absolute. 

c. If a user symbol is defined within a block of coding that is absolute, the value of that symbol is 
absolute. 

d. Variables, undefined symbols, external transfer vectors, and literals get the same relocation as was 
in effect when .END was encountered in PASS 1 . 

e. If the location counter (.LOC pseudo-op) references a symbol which is not defined in terms of a 
relocatable address, the symbol is absolute. 

f. All others are relocatable. 

The following table depicts the manner in which the Assembler handles expressions which contain both absolute 
and relocatable elements. 

(A=absolufe, R=reIocatable) 

A+A-A A-R=R R+R=R and flagged as possible error 

A-A=A R+A=R R-R=A 

A+R-R R-A=R 
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If multiplication or division is performed on a relocatable symbol, it will be flagged as a possible relocation 
error. 

if a relocatable program exceeds 4K, and the assembler is a page mode version, the following warning message 
will be typed at the end of PASS 2: 

PROG > 4K 

5.9 SYSTEM ERROR CONDITIONS AND RECOVERY PROCEDURES 


5.9.1 ADSS-15, DOS-15 and BOSS-15 

Printout 
IOPS 4 


IOPS 0-3 
IOPS 5-77 


5.9.2 BACKGROUND/FOREGROUND 
Printout 

"DEVICE" NOT READY 
.ERR 0-777 


m- ****%. 

5.9,3 RSX PLUS and RSX PLUS III 

h Printout 

MAC-1/O ERROR LUN xx yyyyyy 


Recovery Procedure 

Device is not ready. Ready the device and, 
if it is an I/O BUS device, not a UNIBUS 
device, type 

CTRL R (f R) 

Unrecoverable I/O error. 

Except in BOSS-15, type CTRL P to restart 
MACRO or type CTRL C to return to the Monitor. 


Recovery Procedure 
Ready 11 DEVICE" and then type 
CTRL R (+ R) 

Most of these errors are unrecoverable. Those 
which are recoverable do not require operator 
intervention, For terminal errors type CTRL P 
to restart MACRO or type CTRL C to return to 
the Monitor, 


Recovery Procedure 

is produced on LUN 13: xx represents the Logical Unit 
Number (decimal) and yyyyyy the octal Event Variable 
value indicating the cause of the error * Control is 
automatically returned to TDV 0 


5,9 0 4 Restart Control Entries (not relevant to RSX) 

CTRL P Restart Assembler, if running 

CTRL C Return to Monitor 


5-19 




5 JO ERROR DETECTION BY THE ASSEMBLER 


MACRO-1 5 examines each source statement for possible errors* The statement which contains the error will be 
flagged by one or several letters in the left-hand margin of the line, or, if the lines are numbered, between the 
line number and the location* The following table shows the error flags and their meanings* 

Flag Meaning 

A Error in direct symbol table assignment - assignment ignored 

B 1 8 Memory bank error (program segment too large) 

2* Page error - the location of an instruction and the address it references 
are on different memory pages (error in page mode only) 

D Statement contains a reference to a multiply-defined symbol - the first value 

is used 

E 1 . Symbol not found in user's symbol table during PASS 2 

2 8 Operator combined with its operand may produce erroneous results 

F Forward reference - symbol value is not resolved by PASS 2 

I Line ignored; 

1 . Relocatable pseudo-op in s ABS program 

2 e Redundant pseudo-op 

3* »ABS pseudo-op in relocatable program 

4 S «ABS pseudo-op appears after a line has been assembled 

5* A second * LOCAL pseudo-op appears before a matching *NDLOC pseudo-op 
6 0 An e NDLOC appears without an associated 0 LOCAL pseudo-op 
7 8 Too many a LTORG pseudo-ops (more than 8) 

8* JODEV pseudo-op in e ABS or e FULL program 

L Literal error; 

1 * Phase error - literal encountered in PASS 2 does not equal any 
literal found in PASS 1 
2 e Nested literal (a literal within a literal) 

M Multiple symbol definition - first value defined is used 

N Error in number usage (digit 8 or 9 used under „OCT influence) 

P Phase error; 

1 * PASS 1 symbol value not equal to PASS 2 symbol value (PASS 2 
value ignored) 

2 0 A tag defined in a local area (*LOCAL pseudo-op) is also defined in 
a non-local area 

Q Questionable line; 

1 „ Line contains two or more sequential operators (e*g a , LAC A+*B) 

2 c Bad line delimiter - address field not terminated with a semicolon, 
carriage return or a comment 
3* Bad argument in *REPT pseudo-op 
4 e Unrecognizable symbol with «ABS(P) pseudo-op 

R Possible relocation error 

S Symbol error - illegal character used in tag field 

U Undefined symbol 

W Line overflow during macro expansion 

X Illegal use of macro name or index register 
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In addition to flagged lines, there are certain conditions which will cause assembly to be terminated prematurely. 


Message 


Meaning 


SYNTAX ERR 

? 

NAME ERROR 


TABLE OVERFLOW 
CALL OVERFLOW 
CORE EXHAUSTED 
AT LINE nnnn 


Bad command string, control returns to 
TDV (RSX only) 

Bad command string, retype (not RSX) 

File named in command string not found. 

In all systems except BOSS-15 and RSX, 
the Assembler will restart and accept 
another command string. RSX MACRO 
will return to TDV, BOSS-15 will re¬ 
turn to the Monitor, 

Too many symbols and/or macros 
Too many embedded macro calls 
PASS 3 error - too many symbol references 





APPENDIX A 
CHARACTER SET 


Printing 

Character 

7-bit 

ASCII 

6-bit 

Trimmed 

ASCII 

1 Printing 

Character 

7-bit 

ASCII 

6-bit 

Trimmed 

ASCII 

@ 

100 

00 

Form Feed 

014 


A 

101 

01 

Carriage Return 

015 


B 

102 

02 

ALT MODE (ESC) 

175 


C 

103 

03 

Rubout 

177 


D 

104 

04 

(Space) 

040 

40 

E 

105 

05 

I 

041 

41 

F 

106 

06 

I ii 

042 

42 

G 

107 

07 

# 

043 

43 

H 

110 

10 

$ 

044 

44 

i 

111 

11 

% 

045 

45 

J 

112 

12 

& 

046 

46 

K 

113 

13 

i 

047 

47 

L 

114 

14 

( 

050 

50 

M 

115 

15 

) 

051 

51 

N 

116 

16 

* 

052 

52 

o 

117 

17 

4- 

053 

53 

p 

120 

20 


054 

54 

Q 

121 

21 

; « 

055 

55 

R 

122 

22 


056 

56 

S 

123 

23 

/ 

057 

57 

T 

124 

24 

0 

060 

60 

U 

125 

25 

1 

061 

61 

V 

126 

26 

2 

062 

62 

w 

127 

27 

3 

063 

63 

X 

130 

30 

4 

064 

64 

Y 

131 

31 

5 

065 

65 

Z 

132 

32 

6 

066 

66 

[* 

133 

33 

7 

067 

67 

\ 

134 

34 

8 

070 

70 

3* 

135 

35 

9 

071 

71 

t* 

136 

36 

.* 

072 

72 

«-* 

137 

37 

. 

073 

73 

Null 

000 


< 

074 

74 

Horizontal Tab 

011 



075 

75 

Line Feed 

012 


> 

076 

76 

Vertical Tab 

013 


9 

077 

77 


* 11 legal as source, except In a comment or text. Any characters not in this table are illegal to MACRO-15 
and are flagged and Ignored* 
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APPENDIX B 
PERMANENT SYMBOL TABLE 



Operate 

CLA 

750000 

GSM 

664000 

OPR 

740000 

TCA 

740031 

OSC 

640001 

NOP 

740000 

CLC 

750001 

OMQ 

640002 

CMA 

740001 

LAS 

750004 

CMQ 

640004 

CML 

740002 

LAT 

750004 

LMQ 

652000 

OAS 

740004 

GLK 

750010 

IOT 


RAL 

740010 

> 

£ 

m 

> 

m 

760000 

lOT 

700000 

RAR 

740020 

EAE 

640000 

IORS 

700314 

IAC 

740030 

LRS 

640500 

DBK 

703304 

HLT 

740040 

LRSS 

660500 

DBR 

703344 

XX 

740040 

LLS 

640600 

IGF 

700002 

SMA 

740100 

LLSS 

660600 

ION 

700042 

SZA 

740200 

ALS 

640700 

CAF 

703302 

SNL 

740400 

ALSS 

660700 

RES 

707742 

SML 

740400 

NORM 

640444 

Memory Reference 

SKP 

741000 

NORMS 

660444 

CAL 

000000 

SPA 

741100 

MUL 

653122 

DAC 

040000 

SNA 

741200 

MULS 

657122 

JMS 

100000 

SZL 

741400 

DIV 

640323 

DZM 

140000 

SPL 

741400 

DIVS 

644323 

LAC 

200000 

RTL 

742010 

IDIV 

653323 

XOR 

240000 

RTR 

742020 

I DIVS 

657323 

ADD 

300000 

SWHA 

742030 

FRDIV 

650323 

TAD 

340000 

CLL 

744000 

FRDIVS 

654323 

XCT 

400000 

STL 

744002 

LACQ 

641002 

ISZ 

440000 

CCL 

744002 

LACS 

641001 

AND 

500000 

RCL 

744010 

CLQ 

650000 

SAD 

540000 

RCR 

744020 

ABS 

644000 

JMP 

600000 
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Automatic Priority* 

Index and Limit Register 

Mode Switching 

1 

nterrupt 

Instructions 

Which do 

EBA 707764 



not use Operands 


RPL 

705512 



DBA 707762 

SPI 

705501 

CLLR 

736000 


ISA 

705504 

PAL 

722000 

Index Register Value 

Index Instructions 

PAX 

721000 

X 10000 

Which Take an Immediate 

PLA 

730000 


Nine- 

-bit Operand 






PLX 

731000 


AAC 

723000 






PXA 

724000 


AXR 

737000 






PXL 

726000 


AXS 

725000 






CLX 

735000 



*Not part of the permanent symbol table in B/F MACROA* 
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APPENDIX C 

MACRO-15 CHARACTER INTERPRETATION 


Character 


Function 

Name 

Symbol 


Space 

LJ 

Field delimiter. Designated by in this manual. 

Horizontal tab 

H 

Field delimiter. Designated by in this manual. 

Semicolon 

/ 

Statement terminator 

Carriage return 

) 

Statement terminator 

Plus 

+ 

Addition operator (two’s complement) 

Minus 

- 

Subtraction operator (addition of two's complement) 

Asterisk 

* 

Multiplication operator or indirect addressing indicator 

Slash 

/ 

Division operator or comment initiator 

Ampersand 

& 

Logical AND operator 

Exclamation point 

! 

Inclusive OR operator 

Back slash 

\ 

Exclusive OR operator 

Opening parenthesis 

( 

Initiate literal 

Closing parenthesis 

) 

Terminate literal 

Equals 

= 

Direct Assignment 

Opening angle bracket 

< 

Argument delimiter 

Closing angle bracket 

> 

Argument delimiter 

Comma 

t 

An argument delimiter in macro definitions or an 
exclusive OR operator. 

Question mark 

? 

Created symbol designator in macros 

Quotation mark 

II 

Text string indicator 

Apostrophe 

* 

Text string indicator 

Number Sign 

# 

Variable indicator 

Dollar sign 

$ 

Real argument continuation 

Line feed 

non-printing ^ 

1 

Form feed 

non-printing 

S not applicable 

Vertical tab 

non-printing j 

[ 

Commercial At 

@ 

Concatenation operator in macro definitions 
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Character 


Function 


Name 

Symbol 


Null 

Blank Character 

Ignored by the Assembler 

Delete 

Blank Character 

. Ignored by the Assembler 


Illegal Characters 

Only those characters listed in the preceding table are legal in MACRO-15 source programs, all other characters 
will be ignored and flagged as errors. The following characters, although illegal as source, may be used within 
comment lines and in text preceded by .ASCII or .SIXBT pseudo-ops. 


Character Name Symbol 

Left bracket [ 

Right bracket ] 

Up arrow t 

Left arrow < ~ 

Colon : 
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APPENDIX D 


SUMMARY OF MACRO-15 PSEUDO-OPS 



Pseudo-op 

Section 

Format 

Function 


.ABS 

.ABSP 

3.2.1 

3.2.1 

H.absHnld^ 

H.absp-Hnld^ 

Object program is output in absolute / 
blocked, checksummed format for loading 
by the Absolute Binary Loader, Not sup¬ 
ported in RSX PLUS, RSX PLUS III or B/F 
MACROA, 


.ASCII 

3.8.1 

label*-»). ASCII. ./text/< octal >J 

Input text strings in 7-bit ASCII code, 
with the first character serving as de¬ 
limiter, Octal codes for nonprinting 
control characters are enclosed in angle 
brackets • 


.BLOCK 

3.5 

label *-ej.BLOCK-»jexp^) 

Reserves a block of storage words equal to 
the expression. If a label is used, it 
references the first word in the block. 


.CBD 

3.18 

label*-^.CBD 1 _ 1 NAME t _ J CODEP 

Sets up a COMMON area having the 
name and size specified. The first ele¬ 
ment in the COMMON area is also 
given (base address), (DOS and RSX 

Systems only.) 


.CBDR 

3.19 

label*-*) .CBDR. ,argj 

Enters the starting address of the last 
common block specified in a ,CBD plus 
the argument into the location of the 
.CBDR (RSX PLUS Systems only). 


.DBREL 

3.2.3 

-*).DBRElJ 

Disable bank mode relocation. 


.DEC 

3.4 

-*|.DEC J 

Sets prevailing radix to decimal. 


.DEFIN 

3.16 

H.DEFIN^macro name, args^ 

Defines macros. Not supported in B/F 
MACRO A, 


.DSA 

3.11 

labelCaj.DSA. .expJ 

Generates a transfer vector for the speci¬ 
fied symbol . 


.EBREL 

3.2.3 

-ej.EBREL J 

Enable bank mode relocation. 


.EJECT 

3.14 

-*|.EJECTJ 

Skip to head of form on listing device. 

% y*v 

.END 

3.6 

H.ENDtjSTARTj 

Must terminate every source program, 
START is the address of the first instruction 
to be executed. 


.ENDC 

3.13 

-j.ENDC^ 

Terminates conditional coding in JF 
statements. 


.ENDM 

3.16 

H.endm ) 

Terminates the body of a macro definition. 
Not supported in B/F MACROA. 


.EOT 

3.7 

H .EOTJ 

Must terminate physical program segments, 
except the last, which is terminated by 
• END. 


* All pseudo- 

-ops shown with a 

label generate binary output code. 



D-l 



Pseudo-op 

Section 


Format 

Function 

.ETC 

3.16 

-H.ETC. .arqs.args J 

Used In macro definition to continue the 
list of dummy arguments on succeeding 
lines. Not supported in B/F MACROA. 

.FULL 

3.2.2 

-J 

.fullJ 

Produces absolute, unblocked, uncheck- 

.FULLP 

3.2.2 

1 

.FULLPJ 

summed binary object programs,, Used 
only for paper tape output. Not supported 
in RSX PLUS, RSX PLUS ill or B/F MACROA 

.GLOBL 

3.9 

-*|. G LO B L i_j sy m, sy m, sy m J 

Used to declare all internal and external 
symbols which reference other programs. 
Needed by Linking Loader • 

. IFxxx 

3.13 

H. IFxxx i__,exp J 

If a condition is satisfied, the source 
coding following the .IF statement and 
terminating with an .ENDC statement is 
assembled. 

.IODEV 

3.10 

H.IODEVu .DAT numbers J 

Specifies .DAT slots and associated I/O 
handlers required by this program. Not 
supported in RSX PLUS or RSX PLUS III. 

.LOC 

3.3 

-»j. LOC u exp J 

Sets the location counter to the value of 
the expression. 

.LOCAL 

3.2.4 

H.LOCAL J 

Allows deletion of certain symbols from 
the user symbol table. 

.LST 

3.17 

H.lstJ 

Continue requested assembly listing out- 
put of source lines. Lines between 
.NOLST and .LST are not listed. 

.LTORG 

3.2.5 

H.LTORG^ 

Allows the user to specifically state where 
literals are to be stored. Not supported in 
B/F MACROA. 

.NDLOC 

3.2.4 

H.ndlocJ 

Terminates deletion of certain symbols from 
the user symbol table contained between 
.LOCAL and .NDLOC. 

.NOLST 

3.17 

H.NOLSTj 

Terminates requested assembly listing out¬ 
put of source lines of code contained 
between .NOLST and .LST. 

.OCT 

3.4 

H.OCTJ 

Sets the prevailing radix to octal. 

Assumed at start of every program . 

.REPT 

3.12 

-»j.REPT. . count, nj 

Repeats the object code of the next object 
code generating instruction Count times. 
Optionally, the generated word may be 
incremented by n each time it is repeated. 
Not supported in B/F MACROA. 

.SiXBT 

3.8.2 

label _»j.SIXBT. ./text/< octal > J 

Input text strings in 6-bit trimmed ASCII, 
with first character as delimiter. Num¬ 
bers enclosed in angle brackets are trun¬ 
cated to one 6-bit octal character. 

.SIZE 

3.15 

label-*).SIZEj 

MACRO-15 outputs the address of last 
location plus one occupied by the object 
program. 
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Pseudo-op 

Section 

Format 

Function 

.TITLE 

3.1 

e TITLEuany text string^ 

Causes the assembler to accept up to 50^ 
typed characters. During source program 
assembly operations, a *TITLE causes a 
form feed code to be output to place the 
text starting with a TITLE at the top of a 
page. 




% 





APPENDIX E 
SUMMARY OF SYSTEM MACROS 


System macros (Monitor commands) are defined in the Monitor manuals, and are summarized here for the conven- 
ience of the PDP-15 programmers. 

S/stem macros are predefined to MACRO-15, but not in.RSX, which uses a macro definition file apart from the 
Assembler itself. The file's name is RMC JKX, where XX is the version number which may change over time 8 
To use a system macro, the programmer writes a macro call statement, consisting of the macro name and a string 
of real arguments. 

To initialize a device and device handler 
H •INIT (t _ J ds,f,r 

where ds = .DAT slot number in octal 

f = 0 for input files; 1 for output files 
r = user restart address* 

To read a line of data from a device to a user's buffer 

H .READ, „ds,m,l,w 

where ds = .DAT slot number in octal 

m = a number, 0 through 4, specifying the data mode: 

0 = IOPS binary 
1 = Image binary 
2= IOPS ASCII 

3 = Image alphanumeric 

4 = Dump mode 

I = line buffer address 

w = word count of the line buffer in decimal, including 

two-word header 

To write a line of data from the user's buffer to a device 

H .WRITE 1 _ J ds,m, l,w 

where ds - .DAT slot number in octal 

m = a number, 0 through 4, specifying the data mode: 

0 = IOPS binary 
I = Image binary 


Meaningful only when device associated with a DAT slot ds is the Teleprinter, Typing CTRL P on the 
keyboard will force control to location r. 




2 = IOPS ASCII 

3 = Image alphanumeric 

4 = Dump mode 

I = line buffer address 

w = word count of line buffer in decimal, including the two™ 
word header 


To detect the availability of a line buffer 
H .WAIT^ds 

where ds = .DAT slot number in octal. After the previous .READ, 

.WRITE, or .TRAN command is completed, .WAIT re¬ 
turns control to the user at the instruction following the .WAIT 
expansion. 

To detect the availability of a line buffer and transfer control to ADDR if not available 

H .WAITR^ds, ADDR 

where ds = .DAT slot number (octal radix) 

ADDR = Address to which control is transferred if buffer is not available. 


To close a file 

H .CLOSE^ds 

where ds = .DAT slot number in octal 


To set the real-time clock to n and start it. 

H . TIMER 1 _ I n,c 

where n = number of clock increments in decimal. Each increment 

is 1/60 second (in 60-cycle systems) or 1/50 second (in 50-cycle systems) 

c = address of subroutine to handle interrupt at end of interval 


To return control to the Monitor. 

H -exit; 


MASS STORAGE COMMANDS FOR DECTAPE, MAGNETIC TAPE, AND DISK 


To search for a file , and position the device for subsequent .READ commands 

H . SEEK^ds/d 

where ds = .DAT slot number in octal 

d - address of user directory entry block 



To examine a file director/, find a free directory entry block and transfer the block to the device 


-^,ENTERuds,d, p 

where ds = .DAT slot number in octal 

d= address of user directory entry block 
p= protection code 

The third argument, the protection code, is recognized only by the DOS-15 assemblers 
in other systems it is ignored „ 

To clear device directory to zero 

H . CLEAR ds 

where ds = .DAT slot number in octal 

To rewind, backspace, skip, write end-of-file, or write blank tape on nonfile-oriented magnetic tape 
H . MTAPE Lj ds,xx 

where ds = .DAT slot number in octal 

xx - a number, 00 through 07, specifying one of the functions 
shown below 

00 = Rewind to load point* 

02 - Backspace one record* 

03 = Backspace one file 
04 =■ Write end-of-file 
05 = Skip one record 
06 = Skip forward one file 
07 = Skip to logical end-of-file 

or a number, 10 through 16, to describe the tape configuration 

10 = Even parity, 200 bpi 

11 = Even parity, 556 bpi 

12 = Even parity, 800 bpi 
14= Odd parity, 200 bpi 

15 = Odd parity, 556 bpi 

16 = Odd parity, 800 bpi 


To read from, or write to any user ft le—structured mass storage device 


H .TRAN b l a f d / b # l y w 


where 


a = 3 DAT slot number in octal 
d = transfer direction: 

0-Input forward 

]=Output forward 

2=Input reverse (DECtape only) 

3=Output reverse (DECtape only) 
b = device address in octal, such as block number for DECtape 
I - core starting address 
w - word count in decimal 


May be used with any non“directoned mass storage device. 



To delete a file 


H .DLETE^ds,d 

where ds = .DAT slot number in octal 

d = starting address of the three -word block of storage in user area 
containing the file name and extension of file to be deleted 
from the device. 

To rename a file 

H . RENAM^ds,d 

where ds = .DAT slot number in octal 

d = starting address of two three-word blocks of storage in user 
area containing the file names and extensions of the file to 
be renamed, and the new name, respectively. 

To determine whether a file is present on a device 
-A . FSTAT l _ 1 ds,d 

where ds = .DAT slot number in octal 

d = starting address of three-word block in user area containing 
the file name and extension of the file whose status is desired. 


BACKGROUND/FOREGROUND MONITOR SYSTEM COMMANDS 

To read a line of data from a device to a user's buffer in real-time 

H . REALR 1 _ J ds,n,l,w, ADDR,p 

where ds = .DAT slot number in octal 
m = Data mode specification 

0 = IOPS binary 

1 = Image binary 

2 = IOPS ASCII 

3 = Image Alphanumeric 

4 = Dump mode 

I = Line buffer address 

w = word count of line buffer in decimal, including the two-word header 

ADDR = 15-bit address of closed subroutine that is given control when the 
request made by . REALR is completed. 

p = API priority level at which control is to be transferred to ADDR: 

0 = mainstream 

4 - level of . REALR 

5 = API software level 5 

6 = API software level 6 

7 = API software level 7 
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To write a line of data from user’s buffer to a device in real time 

H .REALW^ds,m, I,w,ADDR,p 

where ds - *DAT slot number in octal 
m = Data mode specification 

0 = IOPS binary 

1 - Image binary 

2 - IOPS ASCII 

3 = Image Alphanumeric 

4 = Dump mode 

I = line buffer address 

w = word count of line buffer in decimal, including the two-word header 

ADDR = 15-bit address of closed subroutine that is given control when the 
request made by . REALW is completed 

p = API priority level at which control is to be transferred to ADDR 

0 ” mainstream 

4 - level of . REAL W 

5 = API software level 5 

6 = API software level 6 

7 = API software level 7 

To indicate, in a FOREGROUND job, that control is to be relinquished to a BACKGROUND job 
H .IDLE 

To set the real-time clock to n and start it 
H .TIMER, a n,c,p 

where n = number of clock increments in decimal. Each increment is 1/60 
of a second (1/50 in 50 Hz systems) 

c = address of subroutine to handle interrupt at end of interval 

p — API priority level at which control is to be transferred to c 

0 = mainstream 
4= level of .TIMER 

5 = API software level 5 

6 = API software level 6 

7 = API software level 7 

To exit from all real-time subroutines which were entered via .REALR, .REALW, .TIMER, or real-time CTRL P 
requests * 

. RLXIT addr 

where addr = The 13-bit entry point address of the real-time subroutine from 
which an exit is to be made. 




DOS SYSTEM MACROS 


The following macros are implemented in the Disk Operating System only . 

To open a file for random access via .RTRAN macros. 

H .RAND j _ j ds,namptr J 

where ds = .DAT slot number in octal 

namptr = name pointer, points to the first word of a 3-word representation 
(.SIXBT) of the file name and extension of the file to be opened 

To enable random access to the blocks of a file previously opened by a .RAND I/O macro. 

-*j .RTRAN ) _jds, d, relblk, bufadd, beg, cnt^) 

where ds = .DAT slot (octal radix) 

d = direction: 

if d-0, direction is input 
if d=l, direction is output 

reiblk = block number (octal radix) 
relative to beginning of the 
file. . .first block is block 1, 
etc. 

bufadd = address of I/O buffer in user's 
core space. 

beg = first physical word of physical 
block to be read or written... 
ignored for disk pack.. .must be 
octal radix, 0<beg <375. 

cnt - number of words, starting with 
beg, to be read or written... 
ignored for disk pack., .must be 
DECIMAL radix, 1< cnt <(253-beg). 

To request a buffer from the buffer pool 
H. GTBUF^ 

To return a buffer to the buffer pool which was obtained via the .GTBUF macro. 

H.gvbuf; 

To obtain access to files on the disk under UFDs other than that of the current user. 

-*j .USER | _ | nn,uic } 

where nn = .UFDT slot number 
uic = UIC 
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request the system loader (.SYSLD) to load and start a specified system program from within a user program. 


-*| .OVRLAi_jnamptr^) 

where namptr = pointer to the first address of the two-word 

.SIXBT representation of the name of the program 
to be loaded. 


WARNING 

All I/O operations should be completed before .OVRLA 
macro is issued. 






APPENDIX F 

SOURCE LISTING OF THE ABSOLUTE BINARY LOADER 


/***ABSOLUTE BINARY LOADER *** 
/ .FULL 

70000A CLOF =700004 


700 1 1 2 

RR8=700112 


700144 

R S B=70 0144 


700101 

R S F = 7 0 0 1 0 1 


017720 

LDSTRT = 1 7720 

703302 

BINLDR CAF 


700004 

CLOF 


700012 

I OF + 10 

70 550 4 

ISA 


740000 

LCDHOD NOP 


707702 

707702 

017726 

LDNXBK=17726 

157775 

DZM 

LDCKSM 

117753 

JMS 

LOREAD 

057776 

DAC 

LDSTAD 

741100 

SPA 


617747 

JMP 

LDXFR 

117753 

JHS 

LDREAD 

057777 

DAC 

LDWDCT 

117753 

JHS 

LDREAD 

017736 

LDNXWD=17736 

117753 

JHS 

LDREAD 

077776 

DAC * 

LDSTAD 

457776 

ISZ 

LDSTAD 

457777 

ISZ 

LDWDCT 

617736 

JMP 

LDNXWD 

357775 

TAD 

LDCKSM 

740200 

SZA 


740040 

HLT 


617726 

JMP 

LDNXBK 

017747 

LD XFR s17747 


057777 

DAC 

LDWDCT 

457777 

ISZ 

LDWDCT 

61*7 7 63 

JMP 

LDWAIT 

740040 

HLT 


017753 

LDREAD=17753 


/CLEAR FLAGS 
/CLOCK OFF 
/INTERRUPT OFF 
/TURN OFF API 
/ C EBA > 3 ( DBA ) j> (NOP) 

/PDP-9 COMPATIBILITY (EEC'S) 

/CHECKSUMMING LOCATION 

/GET STARTING ADDRESS 
/BLOCK HEADING OR 
/START BLOCK 

/WORD COUNT <2'S COMPLEMENT) 


/LOAD DATA INTO APPROPRIATE 
/MEMORY LOCATIONS 
/FINISHED LOADING 
/NO 

/LDCKSM SHOULD CONTAIN 0 
/CHECKSUM ERROR HALT 
/PRESS CONTINUE TO IGNORE 


/EXECUTE START ADDRESS 

/NO ADDRESS ON .END STATEMENT 

/MANUALLY START USER PROGRAM 
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000000 

7001 A A 

0 

RSB 


357775 

TAD LOCKSM 


057775 

DAG LDCKSM 


700 1 0 1 

RSF 


61 7757 

JMP LDREAD+4 


700 1 1 2 

RRB 


637753 

JMP* LDkEAD 



/THE LAST FRAME OF EVERY 

•AbSCP) PRGG IS GARBAGE. 

017763 

LDWA IT = 1 77 63 


117753 

JMS LDREAD 

/PASS OVER LAST FRAME CPDP 

637776 

JMP * LOSTAD 

/COMPATIBILITY)• 

006835 

FNDLDR = • 


003 500 
000000 

HftMWD 003500 j 0 

/HEADER 

000261 
000277 

261i 277 

/HRM START 

000 380 
000000 

380 J 0 


017775 

LOG KSM=1 7775 


017776 

LDSTAD=17776 


017777 

LDWDCT=17777 



/ .END BINLDK 

/*■** END OF LOADER *** 


F-2 



APPENDIX G 
MACROIN 5 ASSEMBLER 
ADVANCED MONITOR SYSTEM 


ADSS-15 8K DECtape systems cannot utilize MACRON 5 if a binary output on DECtape is desired, since the com¬ 
bined size of MACRON 5, the Resident Monitor, and the required DECtape device handler (DTB 8 ) is greater 
than 8K e DECtape (DTC„) input/paper tape output also leads to core overflow „ If, however, paper-tape input/ 
paper-tape output is desired, MACRON5 may be used® Device handlers PRB, PPC, or PPB (for e AB$ or 0 FULL 
programs) may be used as required. 

The MACROIN 5 assembler, which is a device-dependent version of MACRO-15, does permit DECtape I/O on 
an 8K machine* This is possible because MACRO!, though identical to MACRO in function, uses self-contained 
DECtape and Teleprinter I/O routines e This results in a core load which operates In 8K and allows approximately 
390 jq locations for the User’s Symbol Table, 

DEVICE ASSIGNMENTS 

Since MACROI is device-dependent, the user may not use the Monitor ASSIGN command® The assembler per¬ 
forms I/O in the manner described below (as modified by the D and U options): 

a. The user's source program is input from DECtape Unit 1 . 

b a The assembled binary is output to DECtape Unit 2*. 

c 0 The assembly listing is output to the Teletype® 

d 9 The parameter file is input from the Teletype if the P option is used® 

e® MACRO definitions are accepted from DECtape unit 1 during PASS 1 (F option)® This file must be 
named ,MACRO SRC® 


OPERATION 

The operating features of MACROI are the same as described in Chapter 5 for MACRO, with the following 
exceptions: 

Calling Procedure 

MACROI is called by typing MACROI^ after the Monitor’s $ request® When the assembler has been 
loaded, it identifies itself by typing: 

MACROI Vnn (in page mode systems) 

BMACROI Vnn (in bank mode systems) 


"If you want 0 ABS paper tape output, you cannot PIP this binary to paper tape because you will get 9 empty 
frames every 252 words® You must use MACRO as described above® 


on the Teletype and then waits for a command string. 


NOTE 

The command line editing function CTRL U deletes the 
entire line and echoes tU and a carriage return/line 
feed operation on the Teleprinter. 


Additional Options 


The following options may be used in the command string to MACRO! along with the other normal MACRO 
options (excluding I, X and Z): 


Option 

D 

U 


Action 


Default Action 


Suppress binary output and output 
the assembly listing on DECtape 
Unit 2. (file extension: LST) 


A binary, if desired, may be output 
to DECtape 2* The listing is output 
to the Teleprinter. 


The assembled binary is output to The assembled binary is output to 

DECtape Unit 1. DECtape Unit 2 if B option is selected. 


Error Conditions 

MACRO! performs I/O error checking, and outputs the following messages: 


Message 

Meaning 

IOPS 0 

Illegal CAL 

IOPS 1 

CAL* Illegal 

IOPS 3 

Illegal Interrupt 

IOPS 4 

DECtape unit not ready - type CTRL R when ready. 

IOPS 12 

Unrecoverable DECtape Error 

IOPS 13 

File Not Found 

IOPS 14 

Directory Full 

IOPS 15 

DECtape Full 

IOPS 23 

Illegal Word Pair Count 

IOPS 61 

Input Parity Error While Reading Directory or File Bit Map 


Ail of the above error messages, except IOPS 4, are terminal. Type CTRL P to restart MACRO! or type 
CTRL C to call in the Monitor. A more complete description of !OPS errors may be found in the Monitor 
System Manuals or User's Guides listed in the Preface of this manual. 
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APPENDIX H 
MACROA-15 ASSEMBLER 
BACKGROUND/FOREGROUND SYSTEM 


An abbreviated version of the MACRO-15 assembler is provided in addition to MACRO-15, for Background/Fore¬ 
ground systems. MACROA is somewhat smaller than MACRO and can be used where Background core space is at 
a premium. 

MACROA exists because MACROl (see Appendix G) cannot be used in the Background. (It issues IOT instructions 
for one,) 

DEVICE ASSIGNMENTS 

MACROA uses the same .DAT slots as does MACRO excluding .DAT -14, namely: 

-13 Binary Output 
-12 Assembly Listing 
-11 Source Input 
-1 0 Parameter Input 

OPERATION 

The operating features of MACROA are the same as described in Chapter 5 for MACRO, with the following 
exceptions: 

Calling Procedure 

MACROA is called by typing MACROA^) after the Monitor’s $ request. When the assembler has been 
loaded, it identifies itself by typing: 

BF MACROA-15 Vnn 

on the Teletype and then waits for a command string. Only one name is accepted in the command string. 
This means that the F and Z options are illegal and that parameter file input is allowed only from Teletype 
or paper tape. 

Unrecognized Assembly Options 

The F, Z and I options are illegal to MACROA. 

Unrecognized Pseudo-Operations 

The following pseudo-ops are illegal to MACROA: 

.ABS .ABSP .FULL .FULLP 

.REPT . LTORG .DEFIN .ENDM 

.ETC 
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Unrecognized API Instructions 

MACROA does not contain in its permanent symbol table the definitions of API instructions. 
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INDEX 


Absolute binary loader, source listing, F-l 
Address assignments, 2-11 
Address field, 2-2 
Addressing 

Indexed, 2-12 
Indirect, 2-12 

Advanced monitor system, G-1 
Argument delimiters, 4-5 
@ ASCII psuedo-op, 3-13 

Assembler processing, 1-2 
Assembly listing I/O control, 5-20 
Assembly listings, 5-12 

Background/Foreground system, 4-1 

Character interpretation, C-1 
Character set, A-1 
Command string, 5-3 
Command characters, general, 5-2 
Command block definition, 3-20 
Concatenation, 4-7 to 4-14 
Conditional assembly, 3-18 
Created symbols, 4-6 

oDBREL, 3-5 
.DEC, 3-10 

.EBREL, 3-5 
.EJECT, 3-19 
.END, 3-11 

.EOT (end-of-tape), 3-12 
Error conditions, 5-19 
ADSS-15, 5-19 

Assembler, 5-20 
Background/Foreground, 5-19 
BOSS-15, 5-19 
DOS-15, 5-19 
RSX plus , 5-19 
RSX plus III, 5-19 
Expressions, 2-9 

.FULL, *FULLP, 3-4 

Global symbols, 3-15 

Hardware requirements, 1-2 

Integer values, 2-9 

I/O devices, requesting, 3-16 

Label, 2-2 

Listing control (.EJECT), 3-19 


Literals, 2-13 

Literal origin pseudo-op (.LTORG), 3-9 
Location counter, referencing, 2-12 
setting, 3-10 

MACROA-15 assembler, H-l 
MACRO calls within macro definitions, 4-17 
MACRO calls, 4-3 
MACRO body, 4-2 
MACROS, 4-1 
MACROS, defining, 3-20 
nesting, 4-15 
redefining, 4-16 
MACRO-15 language, 1-1 
Multiple filename commands, 5-7 

Nesting of macros, 4-15 
Nonprinting characters, 3-14 
Numbers, 2-8 

Object program output, 3-3 
.OCT, 3-10 
Operation code, 2-2 
Options, assembler, 5-4 

Permanent symbol table, B-l 
Program filename, 5-3 
Program Identification (.TITLE), 3-2 
Program relocation, 5-18 
Program segments (.EOT), 3-12 
Program size, 3-1 9 
Program statements, 2-1 
Program termination (.END), 3-11 
Psuedo operations, 3-1 , D-1 

Radix control (.OCT and .DEC), 3-10 
Recursive calls, 4-18 
Redefinition of macros, 4-16 
Repeating object code, 3-16 
RSX plus and RSX plus III, 5-2 
Running Instructions, 5-15 
Segmented program commands, 5-9 
oSIXBT pseudo-op, 3-13 
.SIZE, 3-19 

Statement evaluation, 2-21 to 2-25 
assembler priority list, 2-25 
numbers, 2-21 
word evaluation, 2-22 
word evaluation of the special cases, 2-24 
Statement fields, 2-15 to 2-21 
address, 2-18 
. comments, 2-20 
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Statement fields (Cont„) 
label, 2-15 
operation, 2-17 

Symbolic address, designating, 3-16 
Symbols, 2-3 
Redefining, 2-6 
special, 2-5 
undefined, 2-8 
Symbol table output, 5-12 
System macros, E-l 

Text handling, 3-12 
Text delimiter, 3-13 
Text statement, 3-13 

User symbol table, deletion of ( e LOCAL, 
e NDLOC), 3-6 


Variables, 2-6 



HOW TO OBTAIN SOFTWARE INFORMATION 


SOFTWARE NEWSLETTERS , MAILING LIST 

The Software Communications Group, located at corporate headquarters in 
Maynard, publishes newsletters and Software Performance Summaries (SPS) 
for the various Digital products* Newsletters are published monthly, 
and contain announcements of new and revised software, programming 
notes, software problems and solutions, and documentation corrections. 
Software Performance Summaries are a collection of existing problems 
and solutions for a given software system, and are published periodi¬ 
cally . For information on the distribution of these documents and how 
to get on the software newsletter mailing list, write to; 

Software Communications 

P* 0. Box F 

Maynard, Massachusetts 01754 


SOFTWARE PROBLEMS 


Questions or problems relating to Digital f s software should be reported 
to a Software Support Specialist, A specialist is located in each 
Digital Sales Office in the United States* In Europe, software problem 
reporting centers are in the following cities* 


Reading, England 
Paris, Frs,nce 
The Hague, Holland 
Tel Aviv, Israel 


Milan, Italy 
Solna, Sweden 
Geneva, Switzerland 
Munich, West Germany 


Software Problem Report (SPR) forms are available from the specialists 
or from the Software Distribution Centers cited below. 


PROGRAMS AND MANUALS 


Software and manuals should be ordered by title and order number* In 
the United States, send orders to the nearest distribution center* 


Digital Equipment Corporation 
Software Distribution Center 
146 Main Street 
Maynard, Massachusetts 01754 


Digital Equipment Corporation 
Software Distribution Center 
1400 Terra Bella 

Mountain View, California 94043 


Outside of the United States, orders should be directed to the nearest 
Digital Field Sales Office or representative* 


USERS SOCIETY 


DECUS, Digital Equipment Computer Users Society, maintains a user ex¬ 
change center for user-written programs and technical application in¬ 
formation . A catalog of existing programs is available* The society 
publishes a periodical, DECUSCOPE, and holds technical seminars in the 
United States, Canada, Europe, and Australia* For information on the 
society and membership application forms, write tos 


DECUS 

Digital Equipment Corporation 

146 Main Street 

Maynard, Massachusetts 01754 


DECUS 

Digital Equipment 
P.O. Box 340 
1211 Geneva 26 
Switzerland 






MACRO™! 5 Assembler 
Reference Manual 
DEC-15-LMACA-B-D 


READER'S COMMENTS 


NOTE: This form is for document comments only* Problems 

with software should be reported on a Software 
Problem Report (SPR) form (see the HOW TO OBTAIN 
SOFTWARE INFORMATION page). 


Did you find errors in this manual? If so, specify by page* 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement* 


Is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 


Please indicate the type of user/reader that you most nearly represent* 

[ | Assembly language programmer 

□ Higher-level language programmer 

□ Occasional programmer (experienced) 

I I User with little programming experience 
I I Student programmer 

□ Non-programmer interested in computer concepts and capabilities 

Name____Date____ 

Organization _____ 

Street_ _ ______ 

City -State_Zip Code__ 

or 

Country 

I 

If you do not require a written reply, please check here. □ 
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P. 0. Box F 
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